Merciful 1

home *** CD-ROM | disk | FTP | other *** search

/ Merciful 1 / Merciful - Disc 1.iso / software / g / gp_fax / gp_fax.txt next >

Wrap

Text File | 1995-10-14 | 178KB | 4,007 lines

GPFAX TR29 GENERIC V2.342 TABLE OF CONTENTS GP FAX INTRODUCTION 5 Specifications 5 Features of GPFax 5 Telecommunications Software and GPFax 7 General 7 Anatomy of the Group 3 Fax 8 Theory 8 GPFax - The Reality 9 Fax Resolution 10 Automatic paging within Created Fax Documents 11 Hints on Creating Fax Documents 12 Simple Documents 12 More Complicated Documents 13 Multitasking and Memory 14 Amiga Serial Device 14 Disk Space 15 Choice of Fonts 15 Printing and the GPFax Printer Driver 16 Printing Received Faxes 17 INSTALLATION 18 The Installation Procedure 18 Floppy Drive Users 18 Manual Installation 19 Absolutely Required Assignments 19 THE GPFAX USER INTERFACE 20 Gadget and Buttons 20 The 'Information' Gadget 20 Decision Gadgets (Buttons) 21 String Gadgets (Text Boxes) 21 Cursor Keys, Number Keys and Numeric Keypad 22 Status Windows 22 Error Messages 23 The Global File Requester 23 WildCard selection of File Names 25 GPFax User Guide Page 1 TABLE OF CONTENTS LOADING GPFAX 26 From WorkBench 26 TOOLTYPES 26 From CLI 28 Program Created Icons 29 FIRST TIME OPERATION 30 Modem Connection 30 Default Environment 30 GPFAX ENVIRONMENT 31 Default Fax Header Details 31 Default Text Font, Margins, Lines per Page 32 Text Margins 33 Pagination and Lines per Page 34 Modem & Service Details 34 OPTIONS 36 THE PHONE BOOK 44 Mouse and Keyboard 44 Phone Book Entries 45 Numbering Grouping 45 Maximum Connection Speed 46 Manual Transmission of Faxes 46 Adding New Entries 47 Cover Page Details 47 Editing a Phone Book Entry 49 CONVERT TO FAX 50 Converting IFF Picture Files 50 Converting ASCII Text Files 51 Formatting Commands 51 Style Commands 52 GPFax User Guide Page 2 TABLE OF CONTENTS TRANSMIT FAX 54 Selecting the Number to Dial 55 Automatic Transmission of Faxes 56 Sending Faxes - Immediate Send 56 Scheduling Faxes 56 Manual Transmission of Faxes 58 Inactivity timer 58 RECEIVE FAX 59 Manual Reception of Faxes 59 Receive Security 59 VIEW REPORTS 60 Type of Displayed Reports 61 Viewing and Printing 61 Deleting Entries and Associated Fax Files 62 Extended Log Reports 64 Re-Transmision of Faxes 65 DISPLAY / PRINT FAXES 66 THE SCHEDULER 68 Editing Fax Schedules 69 The Report Field 69 Viewing Scheduled Faxes 70 ICONIFY 71 Under WorkBench 1.3 71 Under WorkBench 2.0 72 USING AREXX WITH GPFAX 73 The ARexx Port 73 General Notes 73 ARexx Function Key Macros 74 GPFAX USER GUIDE PAGE 3 TABLE OF CONTENTS Special Internal ARexx Functions 74 ARexx on Receive 74 Auto Detection of Fax or Data 74 Case of Text Strings 76 General Commands 76 Program Switch Commands 78 Send/Receive Fax Commands 79 Log Book Functions 80 Font And Margins Commands 80 Special Commands 81 Creating AREXX Scripts 84 USING GPFAX v2.2 and TRAPDOOR or GETTY 85 Definitions: Modems, LISTEN and UNLISTEN 86 Baud rate locking 86 LISTEN, UNLISTEN and Shared Serial Ports 87 Using TRAPDOOR v1.80 and GPFax 88 Using TRAPDOOR v1.83 and GPFax 91 Using FaxGETTY and GPFax 93 APPENDIX A - VIEWFAX 95 APPENDIX B - MODEMS 96 Types of Modems - CLASS 2 96 Types of Modems - CLASS 1 97 APPENDIX C - FAXX IFF 98 APPENDIX D - HANGUP CODES 101 INDEX 104 GPFax User Guide Page 4 GPFAX INTRODUCTION SPECIFICATIONS GPFax has been designed to fully support the fax capabilities of many fax compatible modems. The program provides full send and receive capabilities of group 3, Class 1 or 2 facsimile modems as defined in the preliminary standards documents issued under TIA TR29.2 (Class 2) and in accordance with the CCITT T4 and T30 specifications. There is a number of specific versions of GPFax available. These are GPFax - Supra Class II Version - For Supra modems: Supra Fax Modem Plus and Supra Fax Modem V32 GPFax - Generic Class II Version - Far all other modems, which support the TR29 Class II draft standard such as maestro, ZyXEL U 1496 and many others. GPFax - Special Avtek CD930 MegaPlusFax V32 Version - For Avtek CD930 and NetComm M7F models which do not support RTS/CTS handshaking in fax mode. A special version is required to use Xon/Xoff handshaking. GPFax - Generic Class 1 Version - For modems which support the Class 1 standard such as the USRobotics modems, Avtek Mega Data/fax and NetComm Pocket Fax modems (Rockwell 224ATF), the Comma Corp V3242 and Spirit II (Analog Devices), and others. FEATURES OF GPFax * Send and receive faxes to and from remote fax machines or fax compatible modems. Fully compatible with most modems supporting the Group 3 Class 2 (TIA TR29.2) or the Class 1 fax standards. * Complete 'Intuition' interface - fully mouse or keyboard driven. * Send multiple pages of text or IFF picture files to multiple phone numbers with automatic page markers and fax header stamp. GPFax User Guide Page 5 * Automatic generation of fax cover sheet for company name, voice and fax numbers, to, from, and attention fields, with ability to include letterhead and signature images. * Automatic or manual reception of faxes with time, date and sender identification stamping. * Conversion of text and IFF picture images to 'G3' fax format. Files are stored as CBM defined standard IFF FAXX FORMs. * Conversion of G3 faxes to standard IFF ILBM format for off-line editing with paint programs such as Deluxe Paint program. * GPFax printer driver and 'Print Popup' function allows easy creation and direct transmission of faxes from any standard Amiga word processing, desktop publishing or paint program. * Integrated phone book stores most used numbers and pre-prepared fax cover sheet information. Ability to 'group' numbers. * Complete log book of all transmitted and received faxes. * Print received faxes on standard Amiga printer. * Scheduler for unattended transmission of faxes at later time. * Fully user defined 'environment' for default fax cover pages and font selection. * Full ARexx support with more than 30 commands. * For Class 2 modems, auto-detection between FAX and DATA connections. Interfaces with BBS software to provide a fax server capability for dial-in users. * Iconified for full functional background operation. Application Icon support for Workbench 2 and above. Under Workbench 2, GPFax provides extra functionality of application icons. The user simply 'drags' icons on top of the program icon to preform many program functions. GPFax User Guide Page 6 TELECOMMUNICATIONS SOFTWARE AND GPFax The current version of GPFax is designed to run as a stand alone send and receive fax program. It does not combine any telecommunications features as we recommend or GPTerm-Amiga for your consideration. Although not recommended, it is possible to multitask GPFax with other communications software the GPFax and the communication program both open the Amiga serial device in shared mode, and the other software provides some option to shutdown its monitoring of the serial device. (This capability is often known as an 'unlisten' function.) GENERAL GPFax works on any Amiga under WorkBench 1.3 or higher in PAL of NTSC video modes. Some extra functionality is available under WorkBench 2 as discussed below. We have dispensed with the standard Amiga menus to give the user a more direct 'point and click' interface with the same functionality. In addition, GPFax may be completely driven from the keyboard. If running GPFax from it's own screen, you may not depth arrange the windows but you may move around the screen by dragging the windows with the drag gadget in the window title. GPFax User Guide Page 7 ANATOMY OF THE GROUP 3 FAX THEORY All modern facsimile devices use what is known as the Group 3 facsimile format as defined in the CCITT recommendation document T4. In essence, this describes a procedures for digitally encoding a black and white image on a line by line basis at 3.85 or 7.7 line per millimetre. Half tones can be readily generated by a dithering pattern as on a black and white printer. In many ways the method is similar to that used by the Amiga and other computers to store and display graphic images in a raster line bit map format. Historically, the format derives from the mechanical method by which a facsimile machine reads a document. As it is fed past the scanner element a fraction of a millimetre at a time, each line is digitally encoded than transmitted. The digital image of a typical document might be 1728 pixels wide by 1144 pixels long or 1,976,832 pixels in all. If this image were simply transmitted at 9600 baud with no overhead, it would take approximately 206 seconds or three and a half minutes. To reduce transmission time, various methods of digital compression have been developed. The most common method (and that used by GPFax) is known as HUFFMAN coding or one dimensional run-length encoding. This can be dramatically reduce the image size and hence the transmission time. The mathematics of the encoding method have been optimised for the conversion of text documents with short runs of alternating black and white dots. The method is less efficient for multi-colour computer graphic images, which in extreme cases, can more than quadruple the file size! Facsimile machines are designed to transmit A4 pages of text with a small built-in margin for any errors caused by misalignment of the paper, scanner tolerances and the like. Conversion of different sized pages by reduction or enlargement is also offered by many machines. GPFax User Guide Page 8 GPFax - THE REALITY The GPFax software emulates most of the functions of a typical facsimile machine while adding extra features made available by using computer graphics images, word processors and desktop publishing programs. GPFax attempts to reproduce a standard A4 page 210 mm wide by 297 mm long, as the basis for all fax documents it creates. Since the Amiga can accurately create a precise digital fax image on a dot for pixel basis, the GPFax 'page' is defined as 1728 pixels wide by 1144 pixels high with a vertical resolution of 3.85 lines (pixels) per millimetre. In facsimile terms, this is known as 'standard' resolution. In printing terms this reduces to a horizontal and vertical resolution of 204 dpi by 98 dpi in 'standard' mode or 204 by 196 in 'fine' mode. Traditional facsimile machines often vary in there ability to reproduce the standard A4 page due to misalignment of the paper or other problems. To overcome a potential loss, when directly converting text to fax format, GPFax leaves a margin of 34 pixels on the left and 14 pixels on the right of each page. The 'effective printing area' of each page is thus 1680 pixels wide within this boundary. No margins are provided at the top or bottom. You should leave blank lines if required. When creating fax files by direct printing from within desktop publishing programs, we recommend that you leave margins of at least 15mm (0.5in) on each side of the page to ensure that data is not lost by the remote facsimile machine. For text to fax conversion, GPFax determines the maximum characters per line from the width of the selected font. For example, with the GPFax/18 font with a character width of 11, this means 76 characters per line. When converting IFF images, GPFax will centre all images on the page within the full 1728 pixel area. If the auto-scaling option has been selected, the image will be scaled by the integer result of 1680 divided by the image width - the original aspect of the image is retained. For example, a typical 640 wide image will be doubled and a 320 wide image will be multiplied by a factor of five. If paging has been selected, the scaled size will be limited by the maximum page height of 1144 pixels. (See latter) GPFax User Guide Page 9 When faxes are created by the GPFax printer driver, the page is defined as full width of the fax at 1728 pixels wide. ************************************************************************* * * * Note: It is important to ensure that any faxes created with this * * option have sufficient margins. Allow at least 15 mm (0.5in) margins * * on each side of the document. * * * ************************************************************************* GPFax stamps each transmitted page with one line header information detailing company name, fax number, time and date, and page number. Unlike some fax machines, this is added outside the boundaries of the document and adds approximately three millimetres to the page length. Optionally, you may chose to place this stamp at the bottom of the page followed by an optional horizontal line as an end of page marker. FAX RESOLUTION GPFax will receive faxes in either 'standard' or 'fine ' mode depending on the request from the transmitting facsimile machine or modem. If you intend to use Optical Character Recognition software (after converting the fax to an IFF image), Fine mode provides for 'square' pixels and produces a better result. GPFax is capable of creating faxes in either standard or fine mode. Standard mode has a vertical resolution of 3.85 lines per mm or 98 dpi. Fine mode doubles this to 7.7 lien per mm or 196 dpi. Obviously using fine mode will also double the size of the fax file as well as the time to send it. For most standard faxes you will not find any great advantage in using fine mode since the enhanced resolution will not dramatically improve the quality of the text. However, when using the printer driver with the programs such as Deluxe Paint, PageStream etc., the difference is quite noticeable. If the original images are full colour and ere printed as grey scale, the extra resolution will generate a significantly better dither pattern. Fine or standard resolution may be chosen from the 'OPTIONS' menu or by selecting between printer densities 2 and 6 in programs such as PageStream or Professional Page. GPFax User Guide Page 10 AUTOMATIC PAGING WITHIN CREATED FAX DOCUMENTS When converting your documents to fax format, GPFax can either create one long fax or segment it into A4 length pages. This function is an option available from the 'ENVIRONMENT'. Paging is turned on by default. The automatic paging applies to direct conversion of text or IFF files and when using GPFax printer driver. Consider GPFax acting like a traditional dot matrix printer fed with either continuous fan-folded paper or single A4 sheets. PAGING OFF GPFax acts like a fan-folded printer and the effective page length will be as long as required. (If you have the disk space you could readily create a 30 M (100 foot) long fax! It would only require about 3 Mb of space?) PAGING ON GPFax acts like an A4 sheet feed printer. Each created fax file (page) will have an effective length of 297 mm. GPFax will split any fax document into pages after converting 1144 pixel lies of fax information or on receiving a form feed character or, when converting text on reaching the number of lines per page as defined in the 'ENVIRONMENT'. This number represents the number of lines of printed text, NOT the actual page length which is defined as A4. ************************************************************************* * * * Note: When using desktop publishing programs, turn paging off and let * * the application program perform paging as required. * * * ************************************************************************* Selecting page mode has some other implications. When converting IFF images to fax, the automatic scaling will be limited by the page length. The scaled image cannot be greater than 1144 pixels high. For example, a 320 by 512 image will only be scaled by a factor of two instead of five. GPFax User Guide Page 11 If imbedded commands (see later) for including graphics are used in a text document, the graphic must be fit within the number of lines remaining on the page, otherwise the page will be flushed and the graphic will be placed at the top of the next page. HINTS ON CREATING FAX DOCUMENTS SIMPLE DOCUMENTS For simple notes, use a text editor such as CygnusEd or MicroEmacs (even ED?) to enter the text. Format the text as required in the final fax, ensuring that the number of characters per line (including spaces) is within the boundaries defined by the GPFax environment variables. If page mode is selected you do not need to worry about the document length. When your document layout is correct, simply 'Print' it as you would with a printer. The GPFax printer driver will then automatically create the fax file for you. Alternatively, save the text to disk and then use the 'Convert to Fax' function to generate the fax file. Experiment with the default GPFax font to determine the best 'look' for your application. You may view the results of your efforts by using the 'Display / Print' function to display the created fax. GPFax can automatically convert text and IFF to fax format before sending them. When you are confident with your method, skip the manual convert option and send the files directly using the 'Transmit' function. The text to fax function also supports limited formatting of the text with imbedded bold, italic, and underlining commands, plus the ability to imbed commands to include two colour graphics images. With practice, these functions provide a powerful and rapid method of creating simple fax documents. Before GPFax allows you to transmit a list of files in sequence, it is easy to chain simple text documents and IFF pictures and transmit them in one session. GPfax User Guide Page 12 MORE COMPLICATED DOCUMENTS For documents which require extensive formatting, the BEST METHOD is to use a wordprocessing program such as FinalCopy, ProWrite or PenPal etc. or complete desktop publishing programs such as Professional Page or PageStream to create the documents. Choose a page size of A4, 210mm by 297mm, approximately 70 characters per line and 70 lines per page. Remembering the factors discussed above, it is important that you leave a suitable margin on each side of the page. With desktop publishing programs, if correct paging is required, ensure that the appropriate options for 'form feeds' has been selected within that program and 'PAGINATION' in GPFax is turned off. Once you have created the document in the required format, ensure that GPFax is also running with the printer driver option selected, and just print your document as usual. GPFax will trap the printer output and create a file or files in fax format almost exactly as it would appear on the printer. ************************************************************************* * * * Note: Make sure that your desktop publishing program is set to use * * the 'normal' Amiga Preferences printer and the GPFax printer driver * * option is selected. For example, in PageStream, select the * * 'preferences.Printer' from the Configure Printer menu. * * * ************************************************************************* GPFax User Guide Page 13 MULTITASKING AND MEMORY GPFax has been crafted for the Amiga's multitasking environment. In particular, the input and output serial transfer routines have been optimised for maximum performance. Apart from rapid disk access, transmitting faxes is not a demanding task. GPFax will effectively multitask with other software while sending. Receiving faxes at 192000 baud rate while multitasking, especially on a 68000 machine under WorkBench 1.3 is more demanding. Some other programs are poor at multitasking and may cause problems. A program which excessively monopolises the Amiga's resources, affects the Amiga's interrupts, or is attempting to display intensive multi-bitplane graphics may cause the Amiga to loose incoming serial data. Experiment! If problems arise, find the offending program and do not multitask while running GPFax. These problems will be less evident under Workbench 2 and above. GPFax will operate on any Amiga (PAL or NTSC video) under WorkBench 1.3 or WorkBench 2.0 or higher, with a minimum of 1 Megabyte of memory from a floppy disk drive or a hard disk. Performance has been optimised to allow floppy disk usage but is not guaranteed. When using floppy based systems, run GPFax alone. Because of the memory requirements to display faxes, combined with the speed of reading and writing to floppy disks, we HIGHLY RECOMMEND A MINIMUM OF 1 MEGABYTE OF CHIP MEMORY AND AT LEAST 0.5 MEGABYTES OF FAST RAM MEMORY PLUS A HARD DISK DRIVE for efficient performance. AMIGA SERIAL DEVICE GPFax functions on the standard Amiga serial port or any third party serial board which provides 19200 baud operation with support for RTS/CTS handshaking. Since RTS/CTS handshaking is used to control the flow of data between the Amiga and the modem, a minimum of a standard 7 wire serial cable must be used with the program. (Class 1 versions use Xon/Xoff handshaking.) GPFax User Guide Page 14 GPFax prefers exclusive access to the Amiga's serial device. However, it will operate happily with other programs which use the serial port in shared mode and have a facility for 'un-listening' to the port. (See 'Environment' for further details'). Not all programs will correctly support shared serial port access. When operating in shared mode, other programs must not access the serial port while GPFax is running since this may cause loss of data or upset the special fax initialising routines of the modem. DISK SPACE GPFax saves outgoing and incoming faxes in the 'GPFAX:FAX_OUT' and 'GPFAX_IN' directories. Other information stored in the GPFAX: directory includes the phone book, log book, scheduler, environment and miscellaneous files. Fax files can be quite large, typical 30000 bytes but potentially any size. Also, since GPFax stores a report for all faxes, the size of the log book file can grow indefinitely. ************************************************************************ * * * Regular check on remaining disk space and delete unwanted faxes and * * log book entries when no longer required. * * * ************************************************************************ CHOICE OF FONTS When converting text files to fax format, directly or via the printer driver option, GPFax can use any standard Amiga font including Compugraphic fonts under WorkBench 2. This default font is under user control and stored as part of GPFax's environment data. Experiment! The fonts supplied with the program, GPFax/11 and GPFax/18, are used to create fax cover pages. Both these fonts must be moved to your FONTS:directory (done automatically by the install script). The GPFax/18 font is similar to a Courier/18 font. This is a good, general purpose font for conversion of text to fax and provides approximately 76 characters per line. ************************************************************************ * Note: the GPFax/11 font is designed for use internally by GPFax and * * should not be used for creating your own fax documents. * * * ************************************************************************ GPFax User Guide Page 15 PRINTING AND THE GPFax PRINTER DRIVER With GPFax, all output sent to the standard Amiga printer device from any program can be trapped and converted into a fax formatted file ready for transmission. The GPFax printer driver (GPFax.driver) intercepts all printing to simplify generation of faxes. ANY program which 'prints' to the printer ('PRT:' or printer.device) while GPFax is running can automatically create files in fax format. ************************************************************************* * * * IMPORTANT: Do not install the GPFax.driver from preferences. The * * GPFax.driver will not function if the main program is not running * * and will not act as a stand alone printer driver if installed by * * the Amiga 'Preferences' program. * * * ************************************************************************* The GPFax printer driver is specifically designed to be installed automatically by the program when it is run. GPFax will automatically swap between your Preferences defined printer driver and its own driver as required. We do not advise changing Preferences while GPFax is running as this may result in the GPFax.driver being saved as the default printer driver. The printer driver will create each fax in either standard or fine mode depending on the state of the 'RES - FINE' switch in the Options menu. Alternatively, if printing from program which allows you to select different printer densities, you may select between standard and fine resolution by using density 2 for standard mode and density 6 for fine mode. In PageStream, select the 'Configure Printer' menu and then select Preference.Printer. Use densities 1-6. Do not use density 7. This does not page correctly. For Prowrite, in the Printer Setup Menu select the 'no gap between pages' option. For other programs you may need to experiment to obtain the best output. GPfax User Guide Page 16 PRINTING RECEIVED FAXES When producing hard copy output on your printer, such as generated or received faxes (or the log book reports), GPFax will use the standard printer driver (as defined in Preferences) and output the faxes as a bitmap graphic images to any standard Amiga parallel printer. (Serial printers are not supported.) GPFax assumes standard A4 width paper (210mm wide) and requires a minimum horizontal resolution of 240 dpi and a vertical resolution of 98 dpi for a standard and 196 dpi for fine modes. For best results use a printer which is capable of a least this resolution and set the density (from Preferences) to produce a density of at least this value. (Refer to your printer and Amiga manuals on how to do this.) ************************************************************************ * * * NOTE: Some printers and printer drivers expect to generate an 8 inch * * wide page. Since a fax is designed to be reproduced on an A4 width * * page of 210mm or 8.26 inches, some printer drivers may not be able * * to print a fax at full width. In such cases GPFax will auto-scale * * the width and height of the image to fit the 8 inch page while * * retaining the correct aspect. This may cause problems of 'poor' copy * * quality. If this happens, it can be overcome with many drivers by * * setting the printer preferences to use DIN A4 (if your driver * * supports this!!) or, alternatively, try the WIDE TRACTOR setting. * * This will not actually print off the edge of the paper but may allow * * the printer enough horizontal density to print the full 210mm or * * 8.26 in wide fax. * * * ************************************************************************ GPFax User Guide Page 17 INSTALLATION THE INSTALLATION PROCEDURE BACKUP your master disk now! ************************************************************************* * * * Never run the software from the master disk. Always write-protect * * the master-disk. Make one backupcopy and put the original in a safe * * place. Remember that to obtain program updates you may be required * * to return your original disk to the place of purchase or local * * distributor. Never over copy your original disk with any updates - * * the `original` may also be required for subsequent updated program * * files. * * * ************************************************************************* The GPFax program is designed to operate from its own directory on the hard disk. All associated files and sub-directories must be placed under this main directory path. As recommended by Commodore, we have supplied the standard `Installer` program to install GPFax correctly. Hard Drive installation may be preformed manually, but to ensure correct installation, we suggest you use the `Installer` option from the master disk. Double click in the `INSTALL-GPFax` icon and follow the instructions provided. A NOTE FOR FLOPPY DRIVE USERS If your system does not have a hard drive, the size of the fax files will cause you to run out of disk space very quickly. Top over come this, make a backup copy of the master disk and delete all files not required to run GPFax, such as any files in the FAX_IN and FAX_OUT directories and the `Installer` program. GPFax User Guide Page 18 MANUAL INSTALLATION Create a new directory (drawer) with an appropriate name on your hard disk. Copy the main program GPFax and associated icon to this drawer. Under the is directory, create the two required directories named FAX_IN and FAX_OUT. Copy GPFax:devs/printers/GPFax.driver to your DEVS:printers directory. Copy the GPFax:fonts/GPFax directory and the GPFax.fonts to your Fonts:directory. Absolutely required assignments GPFax MUST know where the main directory is located. After installing the program, modify the assign list file of S:startup-sequence (S:user- startup for WorkBench2) and ASSIGN GPFax: to wherever the main program directory was created. For example, assuming the program was installed on partition WORK, modify the startup-sequence (or assign list file) by adding the ASSIGN GPFax: WORK:GPFax GPFax also uses the T: directory for generating of temporary files. This must be assigned for GPFax to operate. If not already done, we suggest that you add the command `ASSIGN T:RAM:` to your user-startup file. GPFax User Guide Page 19 THE GPFax USER INTERFACE Considerable effort has been devoted to the user-interface for GPFax to provide the user with a powerful program which is easy to use. GPFax provides a fully mouse or keyboard driven interface. We have dispensed with the standard Amiga menu system in order to provide a more direct `point and click` interface. All options are available directly on the screen by selecting the appropriate gadget button. The initial large screen with its main options is referred to as the `Main Menu` in the manual. GPFax provides, the same `look and feel` under any version of the Amiga WorkBench operating system. To manage this, a multi-windowed display is provided, only the front window of which will be active at any time. The only observable difference between Workbench 1.3 and 2 is in the way the iconify icon is displayed and processed. To move the top window to view what is underneath, select the window title gadget with the mouse and drag the window to its required position. Keys may be used to activate various functions within GPFax. All suck keys are marked with an underscore in the gadget`s text. GADGETS AND BUTTONS Gadgets and buttons are either decision gadgets, which preform a function or select an option: string gadgets or text boxes, where you enter text details: or special `information` buttons. By using the mouse, any gadget or button in the active window may be selected at any time. Alternatively, gadget buttons may be selected using the keyboard as discussed below. THE `INFORMATION` GADGET GPFax uses a special global button - the information symbol 'I' - to provide access to more information or wider choices for various options. Selecting this button will either display a file requester, a font requester, or other list. GPFax User Guide Page 20 THE GPFax USER INTERFACE DECISION GADGETS (BUTTONS) Whenever a string gadget or text box is not being used, any of the gadget buttons may be chosen by pressing the appropriate key of the gadget text. The key is usually marked with an underscore. For example, pressing `O` will select the `OK` gadget, pressing `C` gadget will select the `CANCEL` gadget. Pressing the `ESC` key always selects the `CANCEL` option. When an `error message` is displayed, select the option either by pressing the first character of the gadget text, or by pressing `Y`, `N`, or `ESC` keys. `Y` selects the left hand option, `N` or `ESC` selects the right hand (or cancel) option. STRING GADGET (TEXT BOXES) The RETURN key may be used to jump through the series of string gadgets displayed in a window. (The RETURN and `ENTER` keys are functionally identical.) Pressing RETURN will accept the entered text information and activate the next gadget in sequence (if any). Pressing RETURN on the last string gadget in a sequence will deactivate all string gadgets. This allows access to the main keyboard to select other gadgets by using their keys, as above. Pressing RETURN when no string gadget is active, will activate the first gadget in the sequence. Pressing SHIFT + RETURN will ignore the current gadget and select the previous string gadget in sequence. The first gadget of a list activates the last gadget. Pressing CTRL + RETURN, deactivates the string gadgets to allow access to normal keys to select other gadgets or buttons. GPFax User Guide Page 21 CURSOR KEYS, NUMBER KEYS AND NUMERIC KEYPAD (1-=,PgUp, PgDn, End, Home etc.) Providing a string gadget or text box is not in use, and depending on the circumstances, these keys any preform various functions to scroll a list, select a file from a list or move around a display fax. For example, in a file requester, cursor down will scroll the display file list; `PgDn` will jump scroll the list; and the 12 keys on the top row of the keyboard (keys `1` through `=`) will select, or deselect a file from the list. When viewing faxes, `End` displays the bottom right corner of the fax and `Home` displays the top left. Further specific examples of key usage are discussed in the following sections of this manual. STATUS WINDOWS GPFax displays a status window to provide information about the current actions of the program. Many status windows provide an `Abort` gadget to stop that operation. Some provide an `OK` option only. In some cases, the status window will remain until a gadget button is selected. However, in most cases status windows have a default timeout of approximately 5 - 10 seconds and will disappear after this time. *** See FIG 1 *** GPFax User Guide Page 22 ERROR MESSAGES *** See FIG 1 *** If GPFax detects an error while performing a function, a small error window will be displayed. If the error is recoverable, choices similar to `Retry` or `Cancel` will be presented. Fix the problem and select `Retry` to repeat the operation again, or select `Cancel` to quit. In other cases, the error may be fatal and only `OK` or similar option will be available. All other options are locked while error messages are displayed. The `Retry` and `Cancel` gadget buttons in these error windows respond to the mouse, to the first letter of the displayed text, or to the `Y`, which selects the left hand or `OK` option, or `N` or `ESC`, which selects the `Cancel` option. THE GLOBAL FILE REQUESTER A large double file requester is used in GPFax to allow selection of file names. (For example in the `Transmit Fax`. `Display/print Fax` and `Convert To Fax` functions.) This feature has been specifically designed to enable the building of a list from multiple directories. The selected list of files is then fed to the appropriate program function. The displayed list on the right hand side shows the list of selected file names. Initially, when first displayed, the list of files in a directory is shown unsorted. A file may be chosen directly from the display, or the list may be sorted by selecting either the main scroll gadget or the arrow gadgets with the mouse, or by pressing the up or down cursor keys. GPFax User Guide Page 23 *** See FIG 2 *** To build a list of files, highlight the required file name in the left hand display and transfer the name to the right and display. Either type in the required file name and press RETURN, or double click the name of the file with the left mouse button. Alternatively, if a string gadget or text box is not in use, the top row of keys on the keyboard (`1` through `=`) highlight the corresponding file from the top down. The smaller window displays the list of available `Devices`, `Volumes`, or `Assigns`. The gadget button immediately below this window will toggle through three alternatives. Select the gadget with the left mouse button, just click the right mouse button, or press the appropriate key on the keyboard. The `Fax_Out` gadget button at the top of the display allows quick access to the FAX_IN and FAX_OUT directories. GPFax User Guide Page 24 Cursor keys, shifted cursor keys and numeric keypad Pup, PgDn, Home, End, etc. will scroll the left hand display. The gadget buttons below the selected file list on the right, allow manipulation of this list. Highlight the unwanted file with the mouse and select `Remove`. Alternatively, select `Tag` to highlight all files followed by `Remove` to delete all files from the list. When transmitting file, the `View` option allows you to check any particular file. The list of selected files in the right hand display is never sorted. It is designed to feed the selected files in the displayed order to the next program function. Move the file names into the right hand display in the order desired. To transmit a list of files in a specific order, they must be entered into the selected list in that order. WILDCARD SELECTION OF FILE NAMES The file requester supports standard wild card characters when searching for file names. Both AmigaDOS and UNIX style are supported. The AmigaDOS pattern match character are `#` and `?`. The UNIX Style pattern match characters are `*` and `?`. For example, when sending a fax, you may have generated a series of files called PRT123.p01, PRT123,p)2 etc. To selected all these files, first sort the file list by selecting the scroll gadget, then enter PRT123#? into the filename string gadget and press the RETURN or ENTER key. This will the transfer all the matching files to the right hand window ready for viewing or transmission. GPFax User Guide Page 25 LOADING GPFax GPFax may be run from either WorkBench or from the CLI. FROM WORKBENCH To load and run the program from WorkBench either a) double click the main program icon or b) double click any icon created by GPFax Selecting one of the configuration icons (GPFax_env, GPFax_log, GPFax_sch and GPFax_pho) will load and run the main program, then jump to that function. Selecting the icon for a FAX file will load and run the main program and jump to a display of that fax. When the program is iconified, a double click of any of the above icons will activate the program and display that function on the WorkBench screen without opening the main GPFax screen. The operating of the program may be modified adding TOOLTYPES to the main program icon. ************************************************************************* * * * Note: Icon TOOLTYPES are interpreted differently under WorkBench 1.3 * * and Workbench 2.x. If you wish to set a particular tooltype under * * 1.3 you MUST ENTER `name=something`. i.e. LOCKBAUD=TRUE. If you do * * not wish to use a particular tooltype, either remove the keyword * * completely or enclose the whole expression in parentheses, i.e. * * (LOCKBAUD=TRUE). This applies to ALL TOOLTYPES. * * * ************************************************************************* TOOLTYPES FOR ALL VERSIONS OF GPFax SCREEN=WORKBENCH or CUSTOM - Tells GPFax to use the workbench or its own custom screen. USEWBCOLOURS=TRUE - It is not possible to set the colours used by GPFax directly but it is possible to tell GPFax to use your current Workbench colour instead of its own set. This option is mainly for use with grey scale monitors such as the Commodore 2024. GPFax User Guide Page 26 NOSERIAL=TRUE - Do not open the serial device on startup. NOPRINTERDRIVER=TRUE - Disable the GPFax printer driver. QUIET=TRUE - Start GPFax in iconified mode. ICON_X=<val> 0 - 600 and ICON_Y=<val> 0 - 250/190 sets the X and Y coordinates of the application icon on the WorkBench screen. INITSTRING=<xxx> Override the modem initialisation string defined in the GPFax environment. TOOLTYPES FOR CLASS 2 VERSION ONLY BAUDRATE=19200 or higher. Sets the computer to modem (DTE - DCE) connection speed. Does not work with all modems. This is specifically for use with BBS software and high speed modems capable of performing fax connections at 38400 (e.g. ZyXEL). For example, if using GPFax with a `Trapdoor`, it is often better to lock the DTE - DCE speed at the highest possible rate at 19200 or above. This option has been tested with ZyXEL modems at 38400 with TrapDoor. LOCKBAUD+TRUE - lock baud rate to 19200 (or baudrate speed set above) permanently - do not change incoming data baud rate on auto/fax calls. If this is not set (default), when a data call is detected, GPFax will change the serial speed to the baud rate reported by the modem before sending out the ~Data Call' text and executing the AREXX script. (See AREXX Section.) MAXSPEED=<value> where value is 0 - 5 (2400, 4800, 7200, 9600, 12000, 14400) GPFax automatically interrogates the modem to determine the maximum speed capability for fax transmission. Many modems can now use 14,400 for fax. It is possible to override this check by setting the internal MAXSPEED variable in the software. DO NOT USE THIS OVERRIDE UNLESS ABSOLUTELY NECESSARY. In conjunction with the modem, GPFax will intelligently determine the optimum speed for sending and receiving faxes. GPFax User Guide Page 27 ************************************************************************ * * * Special Note: AUTO detection of maximum fax speed is NOT done if * * either (a) GPFax is run with no serial options, or (b) the modem is * * not switched on when program starts. In such cases, the maximum * * speed will be set to the default value of 9600 bps. * * * ************************************************************************ TOOLTYPES FOR CLASS 1 VERSION ONLY MODEMTYPE=USR or AVTEK or COMMA or AC3 - This sets the initialisation string and the method of handshaking to either Xon/Xoff or RTS/CTS (AC3) for the particular modem. (See Appendix C for further details. DELAY=<x> inter-character delay in milliseconds when transmitting command init strings. Generally not required. For USR modems use a value of 2. FROM THE CLI When running GPFax from the CLI, you may use the following command line options - -B<speed> set DTE-DCE speed to 19200 or higher (Class 2) -D<x> Command delay (Class 1 Only) -F<0-5> max fax speed (Class 2 Only) -IT<string> Replace the init string in environment with <string> -L Lock Baudrate for Fax/DATA (Class 2 Only) -NP Disable GPFax printer driver -M<type> USR etc. (Class 1 Only) -Q Open in iconified mode -S Do not open serial device -Z Use WorkBench Screen GPFax User Guide Page 28 PROGRAM CREATED ICONS To allow easy access to various functions, GPFax creates icons for all of its internal configuration files and for both received and converted faxes unless this option is specifically disabled. These icons are GPFax_env The main program environment which holds all the default settings, default fax cover page details and program options. GPFax_pho The phone book. GPFax_sch The table of scheduled faxes and results thereof. GPFax_log The log book holds the results of all sent and received faxes. FAXxxx.Pyy Default icons for all received faxes or those created by converting IFF or text files. The program senses whether these are received or converted faxes. Converted text files will have the suffix `_TFAX.Pyy` to distinguish them from the original files. PRTxxx.Pyy Default icon for all faxes created by using the printer driver option in the FAX_OUT directory. GPFax User Guide Page 29 FIRST TIME OPERATION MODEM CONNECTION When GPFax loads, it expects to have the modem correctly connected to the Amiga serial port (or third party serial board) and switched on. If the check for the modem fails, an error requester will be presented with `Retry` or `Cancel` option. *** See FIG 1 *** If you plan to use the modem during this session, we strongly recommend that it is switched on at this point, otherwise the modem may not be initialised correctly for the fax session. It is not recommended that the modem be turned off while the program is running. Turning the modem off and an again will usually cause its internal registers to be reset to an unknown state. GPFax may not function correctly in such cases. If you wish to run GPFax just to view faxes, run the program with the `no serial` option to override this check for the modem. *********************************************************************** * * * Note: For efficient send and receive operation, GPFax needs to * * interrogate the modem when first run. If the modem is not switched * * on when GPFax is run, it is possible that the modem may be * * incorrectly initialised. Only use the `no serial` option if you do * * not intend to send or receive faxes during the current session. * * * *********************************************************************** GPFax ENVIRONMENT DEFAULT ENVIRONMENT When GPFax is run for the first time, a blank environment form will be displayed. Enter your company or personal details as discussed in the next pages and select `OK`. This will save the environment in the GPFax`s directory, for later reference. GPFax User Guide Page 30 This window displays information required by the program to correctly send faxes, and to create faxes from ascii text files. It also shows the various settings required for the modem-phone connection. Enter the required details and select `OK` to save these details to disk. *** See FIG 3 *** DEFAULT FAX HEADER DETAILS These settings are used create the page header stamp for each fax and details for default fax cover page. Creating a cover page for specific phone numbers is discussed on the `Phone Book` section. COMPANY An important Field. Enter a company or personal name. Used on the fax cover sheet and page header stamp. GPFax User Guide Page 31 Fax No An important Field. Enter your fax phone number. This field is sent as your FAXED in initial handshaking between your modem and remote fax machine or modem when sending or receiving faxes. It is also used on each page header stamp. Phone Your voice phone number. Used on fax cover sheet. LETTERHEAD AND SIGNATURE These are default values. Enter the full path names for your letterhead or signature graphic files. These files MUST be (2) colour standard IFF pictures. If the supplied image contains more than two colours, GPFax will only use the first two colours. These images will be scaled if scaling is on. The LETTERHEAD graphic can be optionally included at the top of a fax cover sheet, before other general information. The SIGNATURE graphic can be optionally included at the bottom of the last page of a transmitted fax. Select either `information` gadget to display a file requester for easier file name selection. DEFAULT TEXT FONT, MARGINS, LINES PER PAGE These fields define the default text font and page margins to be used when converting text files to fax format, either by direct printing through the printer driver or from the `Convert to Fax` option from the main menu. The `Paginate` and `Lines/Page` gadgets control the page format for all fax conversions. GPFax User Guide Page 32 We have supplied two fonts with the program -GPFax/11 and GPFax/18. These fonts are similar in style to Topaz and Courier respectively. The GPFax/18 font generates 76 characters per line. The GPFax/11 font is designed to be used internally by GPFax and should not be generally be used (some characters have been changed for special use). We recommend that you start using the GPFax/18 font. Being a Courier style of font, it provides output similar to that used by many printers and typewriters. Alternatively, select any other font and an associated size. NAME Select the font name (use the `i` gadget to display a list of fonts from your FONTS: directory and select name and size.) (Default: GPFax.font) SIZE The size of the default text font. (Default 18) By definition, this defines the Y Size or height of the font not the X Size or width. We recommend using a font which has a horizontal/vertical size of at least 11 pixels. Smaller fonts may result in unreadable text at the other end. When in doubt, use a larger font and view your converted documents at 1:2 scale to get an idea of the output. ********************************************************************** * * * Note: Changing either the font name or font size will reset the * * margins. The default left margin will set to five (5), and the * * right margin to five less than the maximum characters per line * * allowed for this font/size combinations. The line per page value * * will also be reset to the maximum for an A4 page with a font of * * this height. * * * ********************************************************************** TEXT MARGINS For text to fax conversion, GPFax automatically leaves 34 pixels on the left and 14 pixels on the right of fax page, leaving an `effective printing area` 1680 pixel wide. Margins are used in the same manner as with standard wordprocessors and define the are within this `effective page` where text will be drawn. GPFax User Guide Page 33 All margins are defined in terms of the selected font character size. The LEFT MARGIN - the number of character spaces on the left hand edge of the page. (Default: 5) The RIGHT MARGIN - desired total width of the line in characters of the selected font. The right margin cannot exceed the maximum characters defined by the font width. PAGINATION AND LINES PER PAGE As discussed previously, a `standard` fax is based on a A4 page size with a length of 297mm. GPfax will automatically break all created fax documents into pages if `paginate` if selected. The number of lines per page defaults to the maximum by entering a new value less than or equal to the maximum. ************************************************************************* * * * Note: the `Lines per Page` value does not change the actual page * * length but changes only the number of printed lines of text per page. * * * ************************************************************************* MODEMS AND SERIAL DETAILS These define the parameters for the serial device and the dialling details. DEVICE The Amiga Serial device to be used. UNIT The serial unit number. (Default: 0) RINGS Number of `RINGS` detected before answering phone. (Default value 2) For Supra Silent Answer, set this value to 2 more than your answering machine. ************************************************************************ * * * Note: Because of telecommunications regulations in some countries, * * the `Rings` value defaults to TWO, but you may edit this back to ONE * * if required. * * * ************************************************************************ GPFax User Guide Page 34 SHARED SERIAL DEVICE This defines whether to open the serial device in `shared access` mode or `exclusive` mode. If using ARexx Data script option, you must use `shared` mode. If GPFax and another program do not function together, switch to exclusive mode an run GPFax alone. RETRY The number of redial attempts if a number is busy or does not answer. (Default: 3) REDIAL DELAY The time delay in seconds between redial attempts. Minimum delay is (5) seconds. (Default: 30) DIAL MODE Select the mode appropriate to your telephone service. Either `Pulse` (rotary dial) or `Tone`. (Default: Pulse) PABX This sequence is sent immediately before the phone number when dialling. It is designed for cases where your modem and phones are connected through a switchboard which requires an extra dialling prefix. For example, use, `0W`. If supported by your modem, this will dial a `0` then wait for dial tone before dialling the rest of the number. MODEM INIT This is the actual string of characters sent to the modem to initialise the fax mode. The standard default sequence used by GPFax may vary depending on your modem type. Do not change this sequence unless advised, your modem may fail to operate correctly unless the proper sequence has been entered. (To reset to default string, just delete all characters and press RETURN.) (See Appendix C for details) GPFax User Guide Page 35 OPTIONS The OPTIONS window displays the various user selections which allow you to modify the operation of GPFax. Selections may be made with the mouse or by pressing the appropriate key marked with an underscore. For example, `S` will toggle the `SECURITY` option. Selecting `OK` accepts the settings and saves them to disk. *** See FIG 4 *** GPFax User Guide Page 36 The following options control the main functions of the program SCHEDULER Enables the scheduler. Scheduled faxes will be sent at the defined times. (Default: On) ********************************************************************* * * * NOTE: The scheduler MUST be enabled for correct operation of the * * `Print Popup` function. See below for details. * * * ********************************************************************* AUTOANSWER If enabled, GPFax will answer the phone and start fax reception after detecting the number of `Rings` as defined above. If AutoAnswer is disabled, faxes may still be received manually by selecting the `Receive Fax` from the main menu. (Default: Off) LOG REPORT Turns log reporting on or off. When off, GPFax will not append reports about each session to log book file. (Default: On) PRT DRIVER If selected, GPFax will trap all outputs to the printer (PRT: or printer.device) from other programs and redirect the output through the GPFax.driver to create fax files. The resulting fax is saved in the GPFax:FAX_OUT directory under the name PRTxxx.pyy, where xxx is the next file in sequence an yy is the page number. See `Prt Popup` below for more details. If not selected, normal output to the printer is restored and the default printer driver from Preferences is reinstalled. GPFax will not trap printer output. (Default: On) ************************************************************************ * * * Note: Do not select the GPFax.driver from Amiga Preferences! GPFax * * selects and installs the fax driver or your normal printer driver as * * required. * * * ************************************************************************ GPFax User Guide Page 37 PRT POPUP When printing from another application, GPFax will `popup` a window, allowing you to select the file name for the fax, the phone number and the time and date to send the file. This information will then be entered into the scheduler and the fax will be sent automatically without further user intervention. *********************************************************************** * * * Note: Ensure that 'Prt Driver`, `Prt Popup` and `Scheduler` gadgets * * are selected for correct operation. * * * *********************************************************************** When `Printing` from an application, the Print Popup window will appear. *** See FIG 5 *** a) Enter the file name you wish to call this fax file, or leave at the default name (PRT). b) Enter the phone number or select the `i` gadget to display the phonebook and select a number. c) Select the time and date to send the fax. If these settings are not changed, the fax will be sent immediately the printing has finished. d) Select `QUEUE` to enter the above details into the scheduler so that fax can be queued to be sent. If no phone number has been selected, the file will simply be created and not transmitted. e) Select `STORE` to simply save the printed fax under the given file name and not send it. f) Select `ABORT` to cancel the fax printing. Note that with some applications programs this may bring up a requester such as `not enough memory` or similar. GPFax User Guide Page 38 MODE Determines the operational mode of the modem and allows `Adaptive answer` or automatic detection between FAX and DATA calls. (See ARexx section for more details.) Select `FAX ONLY` or `FAX/DAT.` (Class 1 allows FAX ONLY mode) *********************************************************************** * * * NOTE: For the SUPRA version, you may also select `SILENT ANSWER` * * mode. This enables you to connect an answering machine in parallel * * with your modem. Set the number of Rings to two or more than your * * answering machine. After the answering machine has picked up the * * phone, the Supra modem will listen to the line to detect the fax * * calling tones. If found, the modem will take over the line and * * receive faxes. Refer to your instructions from Supra for more * * details but note that Fax/Data detection is not possible in `Silent * * Answer` mode. It is a FAX ONLY mode. * * *********************************************************************** IMAGE SCALE Defines whether IFF picture files are scaled up with respect to fax size. This setting is a simplistic one, with limited aspect correction. For more efficient scaling, use DeluxePaint or similar program and print the image directly while running GPFax with the printer driver option selected. (Default: On) NOTES ON SCALING Scaling is performed by a simple integer multiplication. Only integer aspect correction is performed. The scaling factor is determined by dividing the fax printing are by 1680 dots by the width of the image. The image width and height is then scaled by this factor. For example, a 640 wide image will doubled in both vertical and horizontal size. A 320 wide image will be quintupled (multiplied by five). Any image wider than 840 will not be scaled. (See the section on `AUTOMATIC PAGING`) ************************************************************************ * * * CARE: Scaling some images may cause excessively long faxes to be * * generated. For example, a 320 by 512 image will be generate a scaled * * fax of 1600 dots wide and 2560 lines high! * * * ************************************************************************ GPFax User Guide Page 39 FORM FEEDS Defines whether GPfax will perform a form feed between separate pages when printing hardcopy of faxes or reports to the parallel printer (Default: On) QUIET MODEM Tells the modem not to turn on the speaker during fax transmission and reception. Simply sends either `ATM0` or `ATM1` to the modem during initialisation of the send and receive phases. It may not function on all modems (Default: Off) PAGE MARKERS Many low cost fax machines do not cut each page as it is received, but instead produce one continuous output of all incoming pages. This option simply adds a dotted line at the end of each page to clearly define the end of page. (Default: Off) STAMP BOTTOM When each page is transmitted, GPFax normally stamps the top of each page with a one line header which defines the time and date of the fax, your company name and fax number, and a count of page transmitted. This option allows you to place this stamp at the bottom of each page instead (Default: Off) WB2 ICON Defines whether an `Application Icon` is placed on the WorkBench screen when the program is run under WorkBench 2.04 or later. Not Available under Workbench 1.3 (Default: On) GPFax User Guide Page 40 VIEW MODE The button allows you to chose the screen resolution used to display faxes. The available choices depend on which version of WorkBench your system is running. UNDER WB 1.3 - A cycle gadget is displayed. Select `HIRES` to use a 640 x 256 screen (200 for NTSC). Select `HR-LACE` to use a 640 x 512 screen (400 for NTSC) UNDER WB 2.04/5 - As above but the display will open using the `standard` overscan setting from WorkBench. UNDER WB 2.1 and WB 3 - An information `i` gadget is displayed. Selecting this will display a standard Screen Mode Requester revealing the various monitor screen modes and overscan settings available with you particular equipment. *** See FIG 6 *** ************************************************************************* * * * NOTES: When the screen mode requester is first displayed, because * * GPFax does not enforce any particular monitor type, the initial * * settings may not be correct. Choose an appropriate display mode and * * select `OK`. * * * * Some of the display modes may not be suitable either for GPFax * * or for your equipment. In general, select the largest display * * screen suitable for your equipment. Be aware that the larger * * the screen display, the larger the amount of CHIP memory * * required to display the fax. * * * * For 2024 users - Select the appropriate 2024 monitor type to * * display the faxes on a 1024 x 1024 screen. * * * ************************************************************************* GPFax User Guide Page 41 USE SECURITY Allows screening of incoming faxes to prevent automatic reception of unwanted faxes (1Junk Faxes`). SECURITY CONSIDERATIONS With the increasing quality of junk faxes being transmitted, if your fax number becomes known, it is highly likely that faxes will be transmitted to your machine at any time from a source unknown to you. GPFax allows a simple screening of incoming calls. During the initial handshake phase between your modem and remote fax machine, the remote fax machine transmits its sender`s ID to your system. With security enabled, this ID string is checked against numbers in the phone book. If a match is found, the call will be accepted and incoming faxes will be saved to disk. If there is no match, the incoming data will be ignored, and an entry will be appended to the log book recording the `apparent` ID string received with the word `JUNK` in the report field. This allows you to check the number from which the call originated. Note, however, that this number is simply the ID string which has been programmed into the sending fax machine. There is no guarantee that the call originated from that phone number. Care must be taken when security is enabled. It is easy to reject calls that you actually wish to receive! It is vital that one number string in the phone book exactly matches the string sent in the ID field by the sender`s machine. GPFax ignores any leading spaces, but other spaces and characters are recognised. If the security rejects a fax when it should not, check the log for the sender`s ID and ensure that there is an exact match for this ID in your phone book. GPFax User Guide Page 42 RES - FINE This switch determines if faxes generated by direct TEXT or IFF conversion are created in STANDARD resolution (98 dpi) or FINE resolution (196 dpi). We suggest STANDARD resolution for normal documents. Select FINE if creating faxes with fine details such as complicated drawings etc. This settings only effects the creation of the fax file. ONCE A FAX HAS BEEN CREATED IT IS NOT POSSIBLE TO CHANGE THE RESOLUTION. When generating fax files from a desktop publishing program by direct `printing` using GPFax printer driver, select between fine and standard mode by changing the printer density between 6 and 2. The following are only available if ARexx is running at the time you run GPFax. (See the `ARexx` section for more details.) AREXX RECEIVE Enables the execution of the ARexx receive script. AREXX DATA Enables the ARexx DATACALL script on auto detection of Data calls. Serial port must be in shared mode for this to function. GPFax User Guide Page 43 THE PHONE BOOK The phone book holds information about often dialled fax numbers. When security is enabled, the phone book entries are also used to screen the transmitted ID string of the sending fax machine to allow or deny permission to receive faxes. *** See FIG 7 *** MOUSE AND KEYBOARD Like all windows in the GPFax system, either the mouse or keyboard may be used to drive the choices. The CURSOR KEYS and PGUP/PGDN scroll the displayed list of phone entries. Pressing the top row of keys on the keyboard (`1` THROUGH `=`) selects or de-selects from the 12 displayed entries. GPFax User Guide Page 44 PHONE BOOK ENTRIES A phone book entry holds the Name / Identification, Fax number, Group Name, Notes and specific fax cover page details for this number. Each cover page associated with a particular number is specified to that number only. Most often when sending to the same number, the cover page details will not vary between calls. However, the details may be readily edited if required. The row of gadget buttons at the bottom of the phone book window allows addition of new entries, editing or deletion of highlighted entries, and other functions. NUMBER GROUPING Each phone book entry can be given a optional group name or number. This is a simple mechanism whereby you can quickly select multiple phone numbers when transmitting faxes. For example, one group may be `dealers`, another `customers` and so on. Entering `dealers` into the group field of the transmit function will quickly highlight all members of this group. *** See FIG 8 *** GPFax User Guide Page 45 MAXIMUM CONNECTION SPEED (* CLASS 2 ONLY *) Each phone book entry has a MAXIMUM connect speed setting. This displays, 2400, 4800, 7200, 9600, AUTO. This setting allows you to request a particular initial MAXIMUM speed for the modem to use when connecting to a remote fax machine. (This is NOT related to the modem to your computer speed which is always at 19200 or higher.) Generally, leave this setting to AUTO and let the modem determine the best speed. However, if you find that certain numbers always connect at a low speed, or, if the modem fails to connect to a remote system normally, drop the initial connect speed until you obtain a reliable connection. This option does may not work on all modems including some earlier Supra modems and depends on the actual ROM revision in the modem. (Contact the manufacturer for details). MANUAL TRANSMISSION OF FAXES Under some circumstances, the person to whom you wish to send a fax may not have a facsimile machine on automatic answer. You may have to call the number manually and ask the person to place their fax machine into receive mode before sending the fax. In these cases you can still enter these numbers into the phone book and can mark them as manual send by entering MAN! As the first four characters of the number. (See `TRANSMIT` for more details.) GPFax User Guide Page 46 ADDING NEW ENTRIES Select the `ADD` Gadget and enter the name, number, group, and any note for a particular remote system. To enable the use of an automatic cover page, select the `COVER` gadget and enter the cover page details. When security is enabled, the phone book entries are also used to screen the ID string of the sending fax machine to allow or deny permission to receive faxes. COVER PAGE DETAILS When a cover page is selected for the first time, the default settings from your environment are copied into the new cover page. These may be edited as required. COMPANY NAME Your name for this conversation. THIS FIELD MUST BE FILLED IN. FROM The name of the person sending the fax. (You?) FAX # Your fax number if you have one. Leave blank if not required. VOICE # Your voice telephone number. THIS FIELD MUST BE FILLED IN. TO The name of the company to which the fax is addressed. ATTN The name of the person to whom the fax is addressed. GPFax User Guide Page 47 FAX # The default number to dial (copied from the phone book number) IMAGE The file path name of any two (2) colour IFF picture to be included as a letterhead. SIG. The file name of any two (2) colour IFF picture to append to the last page of any transmitted faxes. If the `IMAGE` button is highlighted, the image will be included in the header and the signature image (if selected) will be appended to the LAST PAGE of this session. A signature image will only be sent if a header is sent. If no letterhead or signature images are required, toggle these gadgets to `off`. Select the `i` gadget button to display a file requester for easy selection of file path name. Although GPFax will automatically scale any IFF image for letterheads and signatures, the best method is to create the required image with DeluxePaint by using a page of approximately 1024 by 200. Auto scaling of letterhead and signatures images can cause unexpectedly large faxes. (Note that cover pages are generated in the `T:` directory and can be viewed like normal faxes if you wish to see exactly what was sent.) Alternatively, do not use automatic cover pages but generate your own using a full desktop publishing program such as PageStream. Selecting `USE` attaches the defined cover page to the particular phone entry. Selecting `FORGET` will dump this cover page information. GPFax User Guide Page 48 EDITING A PHONE BOOK ENTRY To edit a specific entry, first highlight the required entry, then select `EDIT`. TAG/UNTAG Select `TAG` or `UNTAG` to display the search pattern window. Enter the required pattern and select `OK`. All the four main fields are searched and each entry will be highlighted where a match is found in any field. Standard UNIX style Case Sensitive pattern matching is used. Wild cards are an `*` (match anything) and `?` (match any single character.) Repeated searches are cumulative (will highlight repeated matches to the new pattern). DELETE Deletes the highlighted entries from the phone book. This deletion will be permanent only after the changed phone book is saved to disk. SAVE AND LOAD These gadgets save the currently displayed phone book to disk or reload the old copy from disk. Note that it is possible to change or delete any number of entries then, provided the edited phone book has not been saved to disk, to select `CANCEL` and `LOAD` to recover the old phone book. NOTE ON RECEIVE SECURITY If `SECURITY` has been enabled from the `OPTIONS` menu, GPFax will look up the ID sent by the remote fax machine in the phone book. This is done by comparing the character sequence of the phone book. This is done by comparing the character sequence of the Phone Entry number field with that transmitted by the remote fax machine. RESORT This option sorts the phone entries in alphabetical order by name. Selecting `RESORT` a second time will re-sort the entries by group. Note that entries with no group will be placed first. GPFax User Guide Page 49 CONVERT TO FAX ************************************************************************* * * * Important Note: The Convert to Fax functions should only be used for * * simple applications. For most cases it is better to create faxes * * directly from the application program using the GPFax printer driver * * function. * * * ************************************************************************* The conversion-to-fax routines have been designed to convert quickly any standard ASCII text file or two (2) colour IFF picture file to the G fax format. By default, the converted fax file is placed in the FAX_OUT directory ready for transmission. Being designed to perform quick conversions, this function offers only very limited formatting possibilities. If extensive formatting, half tone images, or drawings are required, use the GPFax printer driver option in association with a desktop publishing program such as ProWrite, Professional Page or PageStream or paint programs such as DeluxePaint. CONVERTING IFF PICTURE FILES If the file is a two (2) colour IFF file, GPFax will create a fax file of the same name with .IFAX appended. IFF picture files should only be two colour images. This function is designed to allow the rapid creation of a simple two colour drawing with added text and send it as a fax. If the image contains more than two colours an option is provided to use just the first two colours. Since a fax is 1728 pixels wide, it is often convenient to create a 1728 pixel wide page in DeluxePaint to produce a full size fax directly. If this method is chosen, ensure that sufficient margins (50 pixels each side) are left to allow for any loss by the receiving station. GPFax will attempt to scale the image if `IFF SCALE` has been selected from the `OPTIONS` menu. All converted IFF pictures are automatically centred on the 1728 dots wide fax page. Scaled images will be scaled then centred. GPFax User Guide Page 50 CONVERTINGASCII TEXT FILES If the file is not an IFF picture, or an already converted fax, GPFax will assume the file is normal ascii text and attempt to convert it to a fax format. This option is designed to write simple letters using a text editor (such as CygnusEd or MicroEmacs) and convert them rapidly to faxes. Text is converted using the `ENVIRONMENT definitions for font, size, left and right margins, and lines per page if page mode is selected. Limited formatting is available within text files by using embedded commands. GPFax performs only limited word wrapping if the line is too long with the remaining text being placed on the following line. This is provided as a safety feature only and should not be relied upon to format text. ************************************************************************* * * * Note. You should ensure that each line of text does not exceed the * * maximum characters per line and is formatted in the required manner * * before converting to a fax. * * * ************************************************************************* If page mode has been selected, GPFax will break the page when the number of printed lines exceeds the lines per page value, or receives a form feed, or includes a graphic which forces the page to exceed 1144 pixels in length. Remember, the number of lines per page is the number of lines of text printed, not the actual page length which is always A4. FORMATTING COMMANDS By embedding the following commands in plain ascii text, limited formatting is available. The control sequence identifier (CSI) is defined as the `\` or back slash character. Formatting commands consist of the CSI followed by one or more characters. Unknown sequences are ignored. Command sequences are not included in the characters per line count. GPFax User Guide Page 51 STYLE COMMANDS STYLE COMMANDS MAY APPEAR ANYWHERE WITHIN THE BODY OF THE TEXT AND REMAIN IN EFFECT UNTIL TURNED OFF. \B Bold On \b Bold Off \I Italics On \i Italics Off \U Underline On \u Underline Off \X Reverse text on \x Reverse text Off \\ Place a single `\` in the text Style commands may be combined to mix effects. For example, the sequence `\B\I\UHello World\u\i\b` would generate the text in bold, italic underlined. OTHER COMMANDS The following commands MUST appear as the first characters of a line and on separate lines. Note that all the following commands must be entered as UPPERCASE. \P Insert a page break at this point \G<file name> Include a two colour graphic file. Example \G work:picture This command must be followed by the full path name to the two colour IFF image file. Graphics will be centred on the page and automatically scaled if scaling has been selected from the options menu. If page mode is on, the graphic (or scaled graphic) must fit within the remaining lines on the page, If not, the GPFax Users Guide Page 52 remaining lines are left blank and the image is placed at the top of the next page. \H Include the header file defined in the `ENVIRONMENT`. \S Include the signature file defined in the `ENVIRONMENT`. The same conditions apply for these commands as for the \G command above. ALWAYS CHECK FILES AFTER CONVERSION! After converting IFF or text, it is advisable to use the `DISPLAY/PRINT` function to view the fax before it is transmitted. As well as saving you time it will also save the embarrassment of badly formatted text! GPFax User Guide Page 53 TRANSMIT FAX This is one of main workhorses of the GPFax program. It allows transmission of any number of prepared faxes, text files or two (2) colour IFF pictures to any number of remote fax machines or fax modems. In general, we recommend that faxes be prepared before transmission with the 'CONVERT TO FAX' option or by using the GPFax PRINTER DRIVER. However, the transmit facility will process the files to be sent and convert any text files to fax format before transmission. From the file requester, select the particular list of files to be transmitted. Any non-fax files will be converted and placed in the FAX_OUT directory ready to be sent. ************************************************************************* * * * Note: The file names used for the converted files are the original * * file names with '_TFAX' appended. Any files in the FAX_OUT directory * * with the same names will be overwritten without warning. * * * ************************************************************************* Once all files have been checked and converted if necessary, the following window will be presented. *** See FIG 9 *** GPFax User Guide Page 54 SELECTING THE NUMBER TO DIAL The phone number to dial may be entered directly into the displayed box or chosen from the numbers in the phone book. Alternatively a group name may be entered. If it is not already active, pressing RETURN will activate the 'NAME OR NUMBER PATTERN' string gadget. Pressing SHIFT + RETURN will alternate between this and the GROUP gadget. NUMBER OR NAME PATTERN Either a number or name pattern may be entered. The number or pattern will be checked against the phone book entries until the first match is found. Pattern matching is case sensitive and uses the Amiga style '#' and '?' characters or the UNIX style '*' and '?' as wild cards. For example, entering 'Pe*' will search for the first entry in the phone book whose first two characters are 'Pe'. If a match is found with a phone book entry, GPFax checks to see if it has an attached cover page and highlights the 'COVER PAGE' button if one is available. GROUP Enter the name of one of the groups in your phone book. All entries associated with that group will be automatically selected. PHONE BOOK To access the phone book directly, press RETURN on a blank field or select the 'i' gadget. From the phone book, highlight the required number(s) to dial. Multiple selections are made by highlighting multiple entries. The phone book may also be edited, have new numbers added or cover page details changed as required (as discussed previously). GPFax User Guide Page 55 COVER PAGES Once the required number or numbers have been selected, highlight the 'COVER PAGE' gadget, if cover pages are required. For SINGLE NUMBERS, if a cover page has been selected and there is no matching selection in the phone book, the default cover page details will be presented allowing entry of 'one-off' details. For MULTIPLE NUMBERS, if the main 'COVER PAGE' gadget is selected, a cover page will be sent only for those entries which have attached cover page information. Otherwise no cover page will be sent with that particular fax transmission. AUTOMATIC TRANSMISSION OF FAXES SENDING FAXES - IMMEDIATE SEND Use the 'NOW' gadget to send faxes to the selected number or numbers. If the number is engaged or busy, GPFax will wait for the 'REDIAL DELAY' time specified in the Environment and retry up to the maximum attempts specified by the 'RETRY' variable. A log book entry is written for successful or failed sessions. SCHEDULING FAXES To send the faxes at a later time, select the 'LATER' gadget. This will display the following window, and allow entry of a specified time and date for each phone number selected. Set the time and date required with the mouse or cursor keys. Cursor Up/Down Hours up or down Cursor Left/Right Minutes up or down SHIFT CURSOR up/Down Days up or down Only a time greater than the current time may be selected. GPFax User Guide Page 56 *** See FIG 56 *** Once the time is set, selecting 'OK' will enter the fax file list and phone entries into the scheduler. If enabled, the scheduler will send the faxes as the time becomes due. If the scheduler is not enabled, the faxes will be queued until you enable the scheduler. ************************************************************************* * * * Note: Once faxes have been entered into the scheduler, ONLY the * * schedule time may be subsequently altered. It is not possible to edit * * the list of faxes or the phone number. * * * ************************************************************************* The scheduler will make a log book entry which records the result of each transmission attempt. If the attempt was successful, the entry will be removed from the scheduler. Manual cover pages cannot be generated for scheduled faxes. The scheduler uses the cover page information associated with the particular phone entry. If the entry has cover details and is enabled, a cover page will be sent, otherwise not. GPFax User Guide Page 57 MANUAL TRANSMISSION FAXES You may also send faxes to people who do not have their facsimile machine on-line permanently. To do this, ensure that the number to dial is preceded by MAN! Select the faxes to be sent as above and select 'NOW'. GPFAX will create all required header and cover files and present you with the following *** See FIG 10 *** Dial the number manually with your normal phone (connected to the modem line), ask them to start their fax machine in receive mode and select the 'SEND' button. INACTIVITY TIMER When sending faxes, GPFax starts a safety timer of 180 seconds. This is reset when result codes are received from the modem. If for some reason the modem does not respond within the time (as can happen with some modems especially on unattended or scheduled faxes), GPFAX will attempt to terminate the call and hang up the phone. ************************************************************************* * * * Note: GPFax depends on the modem sending back the correct responses * * as defined in the various standards. If the modem fails to respond * * under certain conditions, this is a hardware fault with the modem and * * not specifically the responsibility of the GPFAX software. * * * ************************************************************************* GPFAX User Guide Page 58 RECEIVE FAXES Selecting the receive fax function will pick up the phone immediately and attempt to answer an incoming fax call (after initialising the modem if necessary). Unlike the 'AUTOANSWER' option, it does not wait until a 'RING' is detected from the modem. Receive fax is designed to complement the auto answer option allowing you to receive faxes manually. If the auto answer is not selected, this provides a method of switching between voice and fax calls - a human fax/voice switch! If the phone rings, lift the handset and listen for the characteristic guard tone or 'CALLING TONE' (CNG) of a fax machine. This is an 1100 Hz tone lasting for half a second which repeats every three seconds. If the cng is heard, initiate the fax session manually by selecting 'RECEIVE' then replace the handset. Incoming faxes are stored in the FAX_In directory under the names FAXxxx.pyy, where xxx is the next fax number in the sequence an the yy is the incremental page number for this receive session. For example, if the first fax received consisted of two pages, two files named FAX001.p01 and FAX001.p02 would be created on disk. At the end of the receive session a log book entry is made recording the results of the session. This contains the caller's ID, time of call, number of pages and the names of the fax files received (if any!) The received faxes may be viewed or printed directly from the log book or individually from the ~DISPLAY / PRINT FAX' option from the main menu. RECEIVE SECURITY If security is enabled, the caller's ID will be checked against the numbers in the phone book. If a match is found, the fax will be accepted and saved to disk. If no match found, the incoming data will be ignored. GPFax User Guide Page 59 VIEW REPORTS *** See FIG 12 *** VIEW REPORTS displays the 'log book' where the results of all attempted fax sessions are recorded. A log book entry consists of the time and date of the session, the ID sent by the calling station or the number or name to which the fax was sent, the elapsed time of the connection, the number of pages sent or received and the result of the session. Additionally, each entry contains an internal list of the specific files for each session. MOUSE AND KEYS As with all list displays, entries may be highlighted with the mouse, or the top row of the keyboard (keys 'I' through '='). A double click on any entry will display all the faxes associated with the highlighted entries. CURSOR KEYS and PGUP, PGDN, HOME and END scroll or jump scroll the displayed list. The option gadget responds to the key marked by the underscore. GPFax User Guide Page 60 TYPES OF DISPLAYED REPORTS The list of displayed reports may be toggled between showing all fax sessions, 'FAXALL', or only faxes sent 'FAXOUT' or only faxes received 'FAXIN'. VIEWING AND PRINTING To view all faxes associated with a particular log book entry, double click on the entry required. (This action will display all files in the tagged entries.) Also see the 'EXTENDED LOG REPORT' section below. To print copies of all faxes associated with a particular session or sessions, highlight the desired entry or entries and select 'PRTFAX'. This will perform a graphic dump of all fax files in the session to your printer. *** See FIG 13 *** When only a single entry is highlighted, GPFax provides the facility to print a range of the associated faxes. Enter the desired range and select 'OK'. This allows the printing of single pages from a multiple page received fax. ************************************************************************* * * * Note: At the time this manual went to press. Commodore's Postscript * * printer driver (WorkBench 1.1/1) did not perform correct strip * * printing of bitmap images. * * * ************************************************************************* The 'LOGPRT' option produces a printed report of the log entries from the displayed list. GPFax User Guide Page 61 DELETING ENTRIES AND ASSOCIATED FAX FILES To delete entries from the log book, highlight the unwanted entries and select 'DELETE'. An option to delete the actual fax file from the disk is provided. Care should be exercised with this option since it is not possible to recover the files once they have been deleted!. Selecting 'NO' will simply remove the entry(s) from the log book and leave the actual file(s) on disk. THE PAGES FIELD The field shows the actual number of pages sent and the total number of pages in the session. For received faxes, only the total pages are displayed. THE RESULTS FIELD The results of each session are recorded with the following short descriptions. If the scheduler or an ARexx command created the log entry, the suffix '.S' will be added to the description. (See the 'SCHEDULER' section for further details) MODEM The modem did not respond correctly or reported fatal errors during the session. (Fatal error) NOMEM The Amiga ran out of memory for some function during the session. (Fatal error) ABORT The session was aborted. (rare and fatal) NOANS The remote fax machine did not answer. (Not fatal and generally a retry will be attempted.) BUSY The remote fax machine was engaged. (Not fatal.) FAIL Undetermined error. Corrupt files etc. (Fatal) GPFAX user Guide Page 62 DISK? Insufficient space to receive fax. TIME GPFax's default timeout of 3 minutes ran out before modem responded to commands during send fax. ERRxxx (Class 2 Only) An error occurred during sending or receiving fax data. This usually indicates that the connection failed. The error number (xxx) will depend on your brand of modem and the actual error. (See Appendix D about 'hangup codes'.) An error on incoming faxes usually indicates that there were more pages to follow. The last received page may be garbled. An error when sending a fax usually indicates that the last page was not sent correctly. For example, if the log reports 3/6 pages, two pages were received correctly at the remote site but the third page may not have been. NO_EOP The end of page handshaking failed. (ERR50)(Fatal) JUNK The caller attempted to send you a fax but the caller's ID did not match any entry in the phone book. This applies ONLY if security enabled. The number ID of the caller will be displayed in the identification field. OK It actually worked! NOISY Indicates that the modem could not obtain a successful training signal to or from the remote fax machine (Fatal.) (CLASS 1 ONLY) GPFAX User Guide Page 63 EXTENDED LOG REPORTS *** SEE FIG 14 *** GPFAX stores more information in each log entry than is presented in the simple report. To see this extra information, highlight the desired log entry (or multiple entries) and select the 'INFO' gadget. The complete path and file names of all the files associated with this log entry are also shown. If there are more than five files, use the scroll gadgets to move through the list. For Transmitted files, the number of pages actually sent is displayed followed by '+C' or 'NC' to indicate if a cover page was also transmitted. To view or print any of the specific files, highlight the desired file entry and selected 'PRTFAX' or 'VIEW'. GPFax User Guide Page 64 RE-TRANSMISSION OF FAXES From this extended log report you can choose to re-transmit any or all of the faxes from any log entry. For example, if a transmission failed due to line errors, you may wish to resend all the same files again or send just those pages which were not received at the remote site. As another example, you may wish to forward all the faxes to a third party. To re-transmit all or only selected files from the displayed log entry, highlight the files you wish to re-transmit and select the 'RESEND' gadget. This option enters the selected files into the transmit list, look up the phone number in the phone book, then displays the usual transmit window. (See the 'TRANSMIT FAX' section for more details.) GPFax User Guide Page 65 DISPLAY/PRINT FAXES This function will display any fax, whether generated or received. You may create a list of the files to view from the file requester and each will be displayed in sequence. THE DISPLAYED FAX Because of the resolution of a fax, the display is best shown on an interlaced screen (512 pixels high for PAL and 400 for NTSC). We have chosen soft colours for the display but when viewing the fax on a standard monitor it may be useful to adjust the contrast and brightness of the monitor to minimise the flicker. Displaying faxes requires a considerable amount of the Amiga's graphic display or CHIP memory. The display routine has been written to make the best use of the available memory and GPFax will attempt to allocate sufficient CHIP memory to display the complete fax. This may require ut to 700K! If this fails, the program will progressively fall back to display as much as the page as possible. If it is not possible to obtain enough memory to display at least the first 256 lines of the fax, you will need to free some memory being used by other programs before retrying to display the fax. If the fax is longer than a standard A4 page (1144 line, or 2288 for fine mode), or if memory is restricted, only part of the complete fax will be shown. Select the 'MORE' gadget to display the next portion of the fax. Selecting ~NEXT', displays the next fax file in sequence (if any). INVERTING THE DISPLAY Often received faxes have been sent upside down. To view the fax in the correct orientation, select the 'INVERT' gadget. GPFax User Guide Page 66 RESIZING THE DISPLAY Initially the fax is displayed at full size, revealing the top left corner of the image. Scroll around the fax by moving the scroll gadget or by using the cursor and numeric keypad keys (PGUP, PGDN, HOME, END). Once displayed, the fax can be re-displayed at integer scales of 1:1, 1:2, or 1:4 (press keys '1', '2', or '4' on the main keyboard). ************************************************************************* * * * Note: If there is insufficient memory, these options will be disabled * * * ************************************************************************* SAVING OR PRINTING A displayed fax can be printed or saved as an IFF picture file by selecting the 'PRINT' or 'SAVE IFF' gadgets. The current scale factor or invert status has no effect on the printed or saved data. If 'PRINT' or 'SAVE' is selected when only a partial fax is displayed, an option will be presented allowing you to use the complete image or just the partially decoded image currently displayed. It is possible to select portions of a large fax and print or save just those portions. The saved IFF picture is saved in two colours and is by definition 1728 pixels wide. The height of the image depends on the particular fax but will generally be less than, or equal to, the maximum of 1144 pixels. (Double if in fine mode!) GPFax User Guide Page 67 THE SCHEDULER By using the scheduler, faxes can be queued for transmission at a later time, maybe to take advantage of cheaper telephone charges. The scheduler may be toggled on or off fro the main `OPTIONS` menu. If the scheduler is turned off, faxes are simply, queued until the scheduler is next enabled. Also see the `OPTIONS` section for information on the `PRINT POPUP` FUNCTION WHICH ALSO USES THE SCHEDULER. Faxes are entered into the scheduler from the `PRINT POPUP` function or the `TRANSMIT FAX - LATER` option discussed previously. HOW THE SCHEDULER WORKS Once a scheduled transmission has been entered,GPFax looks up the schedule entries every minute and will attempt to send the fax if the scheduler is enabled. If the transmission is successful, an entry is made in the log book and the schedule entry is removed. GPFax will then look for the next schedule if there is one. If a schedule transmission fails, because the number was busy or did not answer, GPFax will re-schedule the transmission up to five (5) times by progressively adding either 1, 4, 9, 16 or 25 minutes to the schedule time. After five unsuccessful attempts, a failure will be reported in the log and schedule reports and no further attempts will be made. If the transmission fails with a fatal error, the schedule will be marked as a failure and no further attempts will be made. Failed schedules may be re-scheduled by editing the transmission times. SCHEDULED FAX COVER PAGES As discussed in the `TRANSMIT FAX -LATER` section, if the phone book entry associated with a schedule has a cover page selected, that cover page will be sent with the fax. Otherwise no cover page is transmitted. GPFax User Guide Page 68 EDITING FAX SCHEDULES *** See FIG 15 *** The fax schedules may be edited from the `SHOW SCHEDULES` main menu option. Only the time of the schedule may be changed, the phone number and list of fax files cannot be changed once a fax has been scheduled. If this is required, the schedule must be deleted and a new schedule entered from the `TRANSMIT FAX` facility. THE REPORT FIELD Just as with log book entries, the scheduler reports the results of each attempt to send the scheduled faxes. DUE Transmission is now due. PENDING Transmission is scheduled for a future time. GPFax user Guide Page 69 OVERDUE Transmission time has passed and the fax will be sent at the next opportunity. RETRY Transmission failed because the number was busy or did not answer. A retry has been scheduled for a later time. MAXTRY Five attempts were made to send this fax but all failed. No further attempts will be made until the user intervenes and re-schedules this fax. Fatal. BADFILE The file list for the schedule faxes was incomplete. GPFax could not find all the files for this session. Maybe one of the files had been deleted after the schedule had been entered. Fatal. ERROR Attempt failed. Maybe hardware or memory or other cause. See log book entry for more details. Fatal. FAILED Modem reported a line error or other undefined error during the attempt to send this fax. Fatal. With most of the above, a report is also appended to the log book. VIEWING SCHEDULED FAXES To view the faxes associated with schedule, highlight the desired entry and select `VIEW`. Note that any associated cover page cannot be viewed. Only the main fax files can be displayed. GPFax User Guide Page 70 GPFax provides the option to iconify the program to minimise memory usage. Selecting `ICONIFY` closes down the main window and places a small icon on the WorkBench screen. To de-iconify and re-open the main program, double click on this icon. ************************************************************************ * * * Note: it is just possible that GPFax may be unable to re-open the * * main display window from the iconified state. The cause of this is * * insufficient memory. In such cases, GPFax just quits. * * * ************************************************************************ Most of the functions of the program are available from the iconified state. GPFax will automatically receive and schedule transmissions while iconified. The printer driver also functions fully while the program is iconified. ************************************************************************ * * * Note: To automatically receive faxes while iconified, the * * `AUTOANSWER` option must be enabled. * * * ************************************************************************ While sending or receiving, GPFax will not open the normal status or error windows but will simply display a small window on the top of the WorkBench screen. USING PROGRAM FUNCTIONS WHILE ICONIFIED UNDER WORKBENCH 1.3 When iconified under WorkBench 1.3, all functions except manual transmit and convert to fax may be performed by a double click on one of the icons created by GPFax. The phone book, log and scheduler reports may be displayed on the WorkBench screen by a double click on the appropriate icon. Note that any windows which appear on the WorkBench screen can only be moved, they cannot be depth arranged as `normal` Amiga WorkBench windows. Also, only the top-most window of any display is movable. GPFax User Guide Page 71 EXAMPLES: To view, double click on a FAX icon. To see reports of the last received fax, double click on the last GPFax_log icon. This will display the log book and the last received (or other) fax may be viewed and printed. UNDER WORKBENCH 2.0 Under WorkBench 2.0, the icon displayed on the WorkBench screen is a special icon known as an `APPLICATION ICON`. It has the name `GPFax Dock`. All of the features of WorkBench 1.3 as discussed above will still work by double clicking. However, a more efficient approach is simply to `drop` any other icon on top of the `GPFax Dock` icon. For example, to convert a text or picture file to fax format, drag the required icon and drop it onto the `GPFax Dock1 icon. Providing the program is not performing another operation, GPFax will sense this event and convert this file to fax format. Alternatively, drop any icon created by GPFax on to the application icon to view faxes or preform other functions. *********************************************************************** * * * Note: These functions are not available if the `WB2 ICON` option * * has been disabled. Also, if GPFax is busy with one task, the * * application icon will not accept any more input. * * * *********************************************************************** GPFax User Guide Page 72 USING ARexx WITH GPFax We have provided GPFax with extensive ARexx capability to allow almost complete remote control of the program from an ARexx script file. Some sample files are included in the rexx_scripts directory on the master disk. All GPfax ARexx macros have the suffix `.gpf`. ********************************************************************** * * * Note: Before attempting to use these commands, consult an ARexx * * manual for details on how to use ARexx! * * * ********************************************************************** THE ARexx PORT GPFax provides a public ARexx pot named `REXX_GPFAX` GENERAL NOTES RETURN CODE ERRORS When using ARexx with GPFax, all commands return the error code in the variable RC to ARexx as follows. Definition Value Notes RC_OK 0 success RC_WARN 5 warning only RC_ERROR 10 something`s wrong RC_FATAL 20 complete or severe failure ********************************************************************* * * * It is VITAL that you check the ARexx return code (value of RC) * * before continuing with any subsequent commands. * * * ********************************************************************* If no errors occurred, most commands return the result of the action in the ARexx variable RESULT ************************************************************************ * * * Important Note: GPFax Log Book * * * * The log book in GPFax is designed to be optional for normal use of * * the program, to save disk/memory space. The ARexx commands make * * extensive use of the log book. You MUST ENSURE LOG REPORTING is * * turned on when using ARexx! * * * ************************************************************************ GPFax User Guide Page 73 ARexx FUNCTION KEY MACROS GPFax provides the facility to attach a specific ARexx script to any of the ten shifted function keys. (The shifted function keys are used to make selection of these a positive action.) The function keys SHIFT F1 - SHIFT F10 will attempt to execute an ARexx script called `FuncXX.gpf` where XX is the number of the function key. For example SHIFT F5 will issue an ARexx command to run the script named `Func5.gpf`. This script must be in `GPFax:` directory or on the standard REXX path. SPECIAL INTERNAL ARexx FUNCTIONS GPFax provides two special ARexx operation as internal functions. These must be enabled from the `OPTIONS` menu. ARexx ON RECEIVE When a fax has been received successfully, GPFax will attempt to execute the ARexx script `Answer.gpf`. You may use this, to print out the log report or automatically print all the faxes received. Another use would be to re-transmit all received faxes to another number. AUTO DETECTION OF FAX OR DATA CALL (CLASS 2 ONLY) This function is designed to complement BBS software by allowing GPFax to act as a front end for sending and receiving faxes on the same line as BBS. Since answering a fax call has a time critical element, and a data call does not, it is often more efficient for GPFax to act as the front end for the BBS software rather than the other way round. The BBS software must support correct shared serial port access, including the facility to `unlisten` to incoming serial data. We are working with the authors of many of the common BBS packages to fully support this automatic fax/data feature. GPFax User Guide Page 74 When answering the phone, Class 2 modems with GPFax can automatically differentiate between Fax and Data calls. This is called 'adaptive answer'. This feature can be enabled by selecting the 'AUTO FAX/DATA' button from the 'OPTIONS' menu. If it is not enabled, GPFax will simply hang up the modem if the incoming call is not a Fax call. If a data call is detected, GPFax will change the serial port speed to the reported baud rate from the modem (unless disabled by LOCKBAUD command) and wait for up to 10 seconds for a incoming serial character. It then attempts to transmit the contents of the file 'GPFAX:DATAMESSAGE.TXT'. This text file is designed to provide the caller with some general instructions about the BBS system she or he has connected to. (If the file does not exist in the GPFAX: directory the program will just continue.) If 'ARexx DATA' IS NOT ENABLED, the program then hangs up the modem. If 'ARexx DATA IS ENABLED, and the serial port is in shared mode, the program 'unlistens' the serial port and attempts to execute the ARexx command script named 'DATACALL.gpf'. This script should pass control to the BBS software. The ARexx command BAUDRATE can be used to established to actual connection baud rate if required. When the BBS software has finished its job, it should return control to the rexx script and thus back to GPFax. GPFax will then close the serial device and re-open it 0.5 secs later at 19200 baud or higher as set at startup (hence dropping DTR and disconnecting the caller safety). It will the re-initialise the modem to fax and start listening to the serial port again to continue normal operations. ************************************************************************* * * * WARNING: This function tells GPFax to UNLISTEN from the serial port * * until this call returns. All GPFax serial events are blocked until * * this ARexx script returns! * * * ************************************************************************* GPFax User Guide Page 75 CASE OF TEXT STRINGS Be aware that a command such as SENDFILE<filename> TO <name> will pass the <name> parameter to GPFax in UPPERCASE. GPFax uses case sensitive name checking in the phone book. If this is a problem, use the command SENDFILE<filename> TO '<name>'. (See ARexx manual for more details) The following abbreviations are used in this section T transmit R receive A all (both T & R) P printed < > parameter string ( ) parameter is optional Commands which read log entries (e.g. 'VIEWLAST') can take an optional parameter of 'T' or 'R' to select between the Transmitted (FAX_OUT) and Received (FAX_IN) reports. If no parameters is given then the command defaults to R to Receive. GENERAL COMMANDS CONVERT <file1, file2..> (Text or 2 colour IFF) output files (file_TFAX.pxx) are placed in the currently defined output directory. If RC=0 the RESULT=last generic filepath. FAXTOIFF <file1,file2..> (OUTDIR <dir> ALL) output files (file_IFF) are placed in <file> directory unless OUTDIR is defined. If a generic file name is used, only the first file will be converted unless the ALL parameter is given. GPFax User Guide Page 76 LASTFILE (<R/P>) (Default R) The RESULT variable returns last file created by program from receiving fax or printfax routines (i.e. FAXxxx, PRTxxx) PRINTFAX <file,file1...filen>*1 VERSION RESULTS variable = version string VIEWFAX <file,file1...filen>*1 QUITFAX quits program COMPANYNAME <new company name> This option has been requested by a number of business users who operate different companies from the same phone number. It is a simple mechanism to remotely change the default company name in the GPFax environment. The cover page and the one line header at the top of each page uses the company name from the environment. This command allows you to easily change the name displayed on the transmitted cover page and fax header. ************************************************************************ * * * WARNINGS * * * * a) This command will change the actual company name in the GPFax * * environment. If you subsequently cause the environment to be * * saved by manually changing any of the environment or option * * settings, this new company name will be saved in the * * configuration. * * * * b) Normally, the company name displayed on any separate cover page * * generated by GPFax comes from the particular phone book entry * * being dialled. After you use this ARexx command, the cover page * * name will be taken from the environment, NOT the phone book * * entry. * * * ************************************************************************ GPFax User Guide Page 77 PROGRAM SWITCH COMMANDS The switch is optional. If RC=0 the command returns current setting or value in RESULT variable. AUTOANSWER (<on/off>) AUTOFAXDATA (<on/off>)enables fax/data detection IMAGESCALE (<on/off>) MODEMQUIET (<on/off>) PAGEMARKERS (<on/off>) PAGINATE (<on/off>) PRTDRIVER (<on/off>) PRTPOPUP (<on/off>) RESOLUTION (<fine/std>) REXXANSWER (<on/off>)(Only functions if auto data selected) REXXDATA (<on/off>) SCHEDULER (<on/off>) SECURITY (<on/off>) STAMPBOTTOM (<on/off>) NOSYSREQ (<on/off>) Turns of System Requester ("disk full" etc.) when executing ARexx commands. GPFax User Guide Page 78 SEND/RECEIVE FAX COMMANDS RECFAX Immediately answer (send ATA) and start receive fax. If RC=0 then RESULT contains full log entry as with option (8) in REPORTLOG below. SENDFAX <file1,file2..*1> TO <num1,num2...>(<groupname>) RC variable records success or failure. If ANY file in the sequence fails the rest are aborted. )Preferably send to ONE number at a time and examine the log to see what happened.) <num> may be number or name or group. This is checked in the phone book entry and cover page will be sent if the phone book entry has one attached. Otherwise no cover page is sent. If no match is found for a number or name, the group name will be checked and files sent to all in that group. *1 <file> if filename ends in .pxx then only a single file is used. Otherwise the filename is treated as a 'generic' file name and all pages with this name will be used. ************************************************************************* * * * Note: If sending to multiple numbers (or group), if ANY fax fails * * the command will be aborted and return error. * * * ************************************************************************* GPFax User Guide Page 79 LOG BOOK FUNCTIONS PRINTLOG REPORT (<T/R/A>)(Default:A for All) print a list of log reports to printer (PRT:) REPORTLOG (<T/R>)<RepNo>(Default: R) 1 last generic filename (or NOFILE) 2 total number of pages (number) 3 last result of send or receive (7 characters) 4 number to/from (20 characters) 5 Date Time (20 char DAY MON DD:HH:MM:SS) 6 transfer time (number) 7 number of pages sent (number) 8 all of above (order 3 4 6 7 2 5 1) VIEWLAST (<T/R>) views last T/R files from log book (Default: R) PRINTLAST (<T/R>) prints last T/R files from log book (Default: R) FONT AND MARGINS COMMANDS If any of below fail, the default GPFax font will be reset. FAXFONT (<fontname><size>)(4>size<500) if RC=0 RESULT="fontname size LM RM LPP" MARGINS (<LM> <RM>)(0 <LM <RM <200) if RC=0 then variable RESULT="LM RM" LINESPERPAGE (<LPP>)(2 <LPP <300) if RC=0 then the variable RESULT="LPP" GPFax User Guide Page 80 After various suggestions from users we have extended the ARexx commands with new commands designed specifically for use with BBS programs such as TrapDoor and Getty for Amiga UUCP ************************************************************************* * * * Note1: ONLY the RECEIVENOW and FCONRECEIVE commands automatically * * handle listen/unlisten. Other commands do not. You MUST specifically * * listen or unlisten the serial device if required according to your * * needs and that of other cooperating software also the serial port. If * * the serial device is not in the correct state an error will be * * returned. * * * * Note2: Some commands either close the serial port or preform an * * unlisten. If this is done, GPFax does not guarantee that the modem * * has been correctly initialised and internally flags this fact. In * * such cases, the next time the modem attempts to answer a call, it * * will re-initialise the modem with the default initialise string. * * * ************************************************************************* SPECIAL COMMANDS OPENSERIAL Opens serial device, sets the default baud rate (19200 if not set with the BAUDRATE command on startup) and starts listening to the serial port. Does not initialise modem. CLOSESERIAL Closes the serial device and flags that modem is not initialised. (This will cause the modem to initialised when doing a manual receive or transmit.) INITMODEM Sends to the modem the init sequence defined in the Environment plus other commands to initialise the modem to receive faxes. Serial port MUST be open! GPFax User Guide Page 81 UNLISTEN stop serial monitor (SEND/RECEIVE disabled) LISTEN start serial monitor ************************************************************************* * * * Note: These commands do what the suggest. `LISTEN` will NOT open the * * serial port or initialise the modem. If the serial port has been * * closed, `LISTEN` will return an error. `UNLISTEN` also flags the fact * * that the modem initialisation is no longer valid. * * * ************************************************************************* LOCKBAUD (<on/off>) (Default: Off) (Class 2 only) This switch determines whether GPFax changes to the incoming baud rate when DATA calls are detected. If the baud rate is locked, GPFax will keep the baud rate locked at 192000 or whatever rate was defined on startup. BAUDRATE returns the baud rate of the current connection. For use by data scripts an auto detection of a data connection. It is not possible to change the baud rate at which GPFax operates after you have started the program. If you wish to run at higher than 192000 you must set this when GPFax is first run. ************************************************************************ * * * Note: Do not confuse this with the BAUDRATE setting used in the * * TOOLTYPE of the GPFax icon. * * * ************************************************************************ SCHEDULEFAX <TIME in MINS> <file,file> TO <num,num,..(group)> The command is effectively the same as sendfax but has extra parameter of TIME. The TIME variable is in minutes AHEAD of current time and the value must be greater than zero. GPFax User Guide Page 82 RESETSCHEDULES <TIME mins> this command resets all currently queued scheduled faxes to the current system time + TIME (The command does not check status of schedules. It resets all schedules irrespective of what the error was.) COVERPAGES <ON/OFF> Allows you to determine and if cover pages are to be sent when using ARexx, send or schedule commands. If a phone number or group number is found in phone book and has an attached cover page, this setting allows you to override the default and not send the cover. (Default: ON.) RECEIVENOW and FCONRECEIVE (CLASS 2 ONLY) ************************************************************************ * * * Note: Because Class 1 modems have no consistent adaptive answer * * standard, fax/data detection and associated functions are not * * provided in the Class 1 version of GPFax. None of these ARexx * * commands are available in the Class 1 version. * * * ************************************************************************ These are the two main commands for running GPFax in conjunction with BBS software and external `trapdoor` style or UUCP/Getty programs. When external program causes the modem to answer the phone, it must determine if the call is fax or data. The best method of detecting a fax call is to look for a +FCON command from the modem. GPFax provides two commands to initiate receipt of a fax depending on exactly how the external program works. Both commands effectively perform the same operation, however, there are some very important differences between FCONRECEIVE and RECEIVENOW. FCONRECEIVE is designed to be called immediately after receiving the `+FCON` response from the modem. (At this point, the calling program must have the baud rate set to 192000 and must also be in `unlisten` mode.) GPFax will process any handshaking commands while waiting for the GPFax User Guide Page 83 subsequent `OK` from the modem before initiating the receive. On the other hand, RECEIVENOW does not wait for the `OK` and is designed to be called where the external program has received the `OK` from the modem AFTER the `+FCON`. The actual function of the commands are as follows Do a default LISTEN if required begin receiving of faxes and save incoming files do UNLISTEN returns to calling rexx script CREATING ARexx SCRIPTS Creating an ARexx script to run from a BBS package which calls GPFax is not difficult problem but several aspects need to be considered. Before writing the script it is important to clearly map out the exact functions you expect each program to perform. With the FCONRECEIVE command, GPFax expects that the external program will be sent an 'ATA' (or auto answer) to the modem, has swallowed the FAX/DATA result to determined if it is a FAX call, then waited until a '+FCON' response has been received. Depending on exactly which external program you are using, it may be best to allow GPFax to send the main modem initialisation commands. This will ensure that the modem has been correctly set up to receive fax or data calls. ************************************************************************* * * * Note: It is important to realise that once GPfax has done the * * initialisation, the modem should not be reset. i.e. Do not send an * * 'ATZ' or similar command, switch off, or have any setting that will * * cause the modem to be reset. * * * ************************************************************************* GPFax User Guide Page 84 A sample setup would be run GPFAX with FAX/DATA modem set wait for GPFax to startup (e.g. using 'waitforport') send GPFax an UNLISTEN run BBS and frontend then START wait for serial get RING issue ATA determine FAX or DAT if FAX response received wait for +FCON call GPFAX with FCONRECEIVE goto START With both FCONRECEIVE and RECEIVENOW, time delays can be critical. The fax call will not wait for more than about THREE SECONDS (MAX) to continue with fax reception. Be careful about the modem initialisation between Fax and Data calls. Under some circumstances, it also may be necessary to re-initialise the modem (using LISTEN/INITMODEM/UNLISTEN commands) after receiving the call and especially after the external program makes data calls. USING GPFAX WITH TRAPDOOR OR GETTY The information supplied herein should be sufficient to get GPFax working with TrapDoor v1.83 and FaxGETTY. The information should also provide a basis for development of scripts to work with other programs including DLG (with or without TrapDoor) and other BBS packages. Any people developing scripts which work with GPFax are urged to place their scripts in the PUBLIC DOMAIN and send them to Richard Carde at GPSoftware so they may be included in any new distributions. GPSoftware can be contacted at the addresses shown elsewhere in this document. GPFax User Guide Page 85 ************************************************************************* * * * Note: The example scripts overleaf are examples only. Most likely * * you will need to modify these to suit your local conditions. If you * * have problems, contact Richard Carde at GPSoftware for more details * * * ************************************************************************* SHELL SCRIPTS All AmigaDOS scripts mentioned in this document MUST have the 's' (script) protection bit set and therefore you should be using a least AmigaDOS 1.3 Shell. As we cannot test under every possible machine configuration, it is advisable that you use a standard AmigaDOS 1.3 (or higher) Shell. ARexx SCRIPTS ARexx will look for scripts in the default directory, from where the GPFAX has been, and in the REXX: directory. It is advisable that all scripts be located in GPFAX: directory and that you CD to GPFAX: before executing the program. DEFINITIONS: MODEM CONFIGURATIONS, LISTEN AND UNLISTEN It is important that you understand your modem, it's configuration settings and some things about handling the serial port on the Amiga. If you do not know whether your modem supports DTE baud rate locking then you should read your modem manual to understand what is meant by this term. Most new high-speed modems support baud rate locking. ************************************************************************* * * * Note: We use the term 'baud rate' to refer to the connection speed * * between the computer (DTE) and the modem (DCE). In other words, the * * speed of the Amiga serial port. It is does not refer to the actual * * bits per second used by the modem when data is being sent or received * * from a remote DCE. This will vary between 2400 b.p.s (bits per * * second) and 19200 b.p.s or higher depending on your modem and the * * quality of the phone line. * * * ************************************************************************* BAUD RATE LOCKING Baud rate locking means that the communication speed (DTE speed) between the computer and the modem is locked at a constant value (normally 19200 GPFax user Guide Page 86 for Fax), regardless of the modem to modem connection rate. (DCE speed). The modem will buffer the data and sends it out at the DCE speed. Usually the DCE speed is less than the DTE speed so the modem must control the flow of data from the computer with some form of handshaking from the computer with some form of handshaking to start and stop the flow of data as required. Normally RTS/CTS hardware handshaking is used for Fax CLASS 2 modems, and XON/XOFF for Fax Class 1 modems. LISTEN, UNLISTEN AND SHARED SERIAL PORTS The Amiga provides only a primitive mechanism for allowing multiple programs to access the one serial port. However, this works well providing all programs observe a few simple rules. Several programs can productively access to the Amiga's serial port at once providing they all open the device using the 'SHARED SERIAL' option. But only one program may effectively CONTROL the port at any given time. Note that when two programs share the serial port, neither program will be able to drop DTR to disconnect the modem while the other program still has the serial device open. If you cannot use the '+++ATH' command method, you will have to physically close the serial device on both programs to drop DTR. (Don't forget to reopen it afterwards!) In order to process incoming data from the modem at high speed, a program sends a request to the serial device for one character, then goes to sleep (WAITs). When characters arrive at the port, the serial device buffers them and notifies the calling program that a character is available. After processing this character, and any other buffered characters, the program then queues another request for one character and returns to wait state. A program is said to be in 'LISTEN' mode when it has such a queued request pending. When in listen mode, the serial port is effectively blocked from use by other programs. If a second program wishes to access the port, the first program must be told to cancel its waiting request and then not look at the port (UNLISTEN), leaving it free for the use of the second program. The GPFax ARexx command LISTEN tells the program to watch (listen to) GPFax User Guide Page 87 the serial port for serial data. As defined by the Fax standards,GPFax sets the DTE-DCE speed at 19200 baud unless changed to a higher speed when the program is first run. Therefore, when any application tells GPFax to talk to the modem, it must ensure that the serial device baud rate has been set to the same speed (192000 as is being used by GPFax. Most fax modems automatically set the speed to 19200 baud when they enter FAX mode. TrapDoor and FaxGETTY should have already set the modem speed (19200) when control is passed to GPFax. UNLISTEN is the GPFax ARexx command which tells the program to stop waiting for serial data. This allows other programs to talk to the modem while GPfax is running (if in SHARED serial mode) but only AFTER you have issued the unlisten command. USING TRAPDOOR v1.80 AND GPFax To use TrapDoor v1.80 (any version less than 1.83), you need to use GPFax to answer the incoming call. Versions of TrapDoor below version 1.83 cannot answer FAX calls. Calls are answered in the following sequence: a. GPFAX answers the call and determines if the call is a FAX or DATA connection. b. If the incoming is a FAX call, GPFAX processes the incoming fax and returns to wait for the next call. c. If the call is a DATA call, the DataMessage.txt file is displayed (if it exists) and then the DATACALL.GPF ARexx script is executed. That script should run trapdoor in ANSWER IMMEDIATE mode. d. If the DAT call is a FIDO MAIL call, trapdoor can handle it and then will return. e. If the DATA call is a user for the BBS, then you must GPFax User Guide Page 88 set up trapdoor to work with your BBS and modem configuration. The following config and scripts should be used if your modem supports BAUD RATE LOCKING (e.g.: Supra, ZyXEL) and the baud rate used MUST be set to 19200 unless the modem is capable of performing fax operation at a higher speed (ZyXEL). You should also make sure GPFax is run in LOCKED baud rate mode if your modem supports it, and that you interpret the result of the BAUDRATE ARexx command correctly. GPFax MUST BE IN SHARED SERIAL MODE with the following options set: Auto/Answer FAX/DATA mode ARexx DATA ---------- DATACALL.GPF script starts here ---------- /* * $VER: DataCall.GPF 0.03 (5.11.92) rsc * this script will start TRAPDOOR v1.80 or below */ options result address REXX_GPFAX baudrate baud=result address command `FIDO:trap/trapdoor` ANSWER IMMEDIATE ----------script ends here ---------- The following modifications are required when non-locking baud rate GPFax User Guide Page 89 modem is used (e.g.: Maestro 9600XR Fax/Data modem) TrapDoor will require a different config depending on baud rate used, and the LOCK command in the TrapDoor.cfg must not be specified. --------- DATACALL.GPF script starts here ---------- /* * $VER: DataCall.GPF 0.03 (5.11.92) rsc * this script will start TRAPDOOR v1.80 or below */ option results address REXX_GPFAX baudrate baud=result if (baud=300) then CONFIG="mail:TrapDoor300.cfg" else if (baud=300) then CONFIG="mail:TrapDoor300.cfg" else if (baud=1200) then CONFIG="mail:TrapDoor1200.cfg" else if (baud=2400) then CONFIG="mail:TrapDoor2400.cfg" else if (baud=4800) then CONFIG="mail:TrapDoor4800.cfg" else if (baud=7200) then CONFIG="mail:TrapDoor7200.cfg" else if (baud=9600) then CONFIG="mail:TrapDoor9600.cfg" else if (baud=19200) then CONFIG="mail:TrapDoor19200.cfg" else say "funny baudrate" address command `trapdoor` `config` CONFIG ANSWER IMMEDIATE --------- script ends here ---------- Each of the MAIL:TrapDoor<baud>.cfg files should have the appropriate BAUD keyword set and any other settings specific to the modem. ************************************************************************* * * * Note: The above procedures are NOT recommended. It is recommended * * that you obtain TRAPDOOR v1.83 and use it if you intend to use your * * fax modem with DAT/MAIL calls. * * * ************************************************************************* USING TRAPDOOR V1.83 AND GPFax Using TrapDoor v1.83 and GPFax is quite simple. All that is required are changes to two (2) lines of your TRAPDOOR.CFG file. It is necessary for GPFAX to be in SHARED serial mode and already running is the UNLISTENED state before TrapDoor is started. An INIT_FAX script is supplied below to do this automatically. Some background on how things work: TrapDoor v1.83 has two new commands specifically for use with FAX. These commands are FAXSTRING and FAXCOMMAND and work in the same way and the BBSCOMMAND does. FAXSTRING should be set to "+FCON" and FAXCOMMAND set to "MAIL:rec_fax". The REC_FAX script is listed below. This will instruct TRAPDOOR to start the MAIL:rec_fax script when the string +FCON is received from the modem. TrapDoor`s baud rate should be set to 19200, however, for faster DATA communications, the BAUD can be set to anything. If you have problems, we advise that BAUD be set at 19200. The MAIL:rec_fax script is shown below and is a standard AmigaDOS script which should have the `S` (script) bit set. We have presented below, two examples of different methods in handling TrapDoor. The following script uses the LISTEN/UNLISTEN commands, and although GPFax is UNLISTENED, it has the serial device open. Hence, your config for TrapDoor would require MODEMHANGUP string to be "~+++~ATH|". GPFax User Guide Page 91 --------- start of the MAIL:rec_fax script --------- rx "address REXX_GPFAX fconreceive" wait 5 ; ;place other commands in here to automatically VIEW/PRINT/LOG any ;activity ; --------- end of the MAIL:rec_fax script --------- The INIT_FAX script is shown below and can be EXECUTED or run if the `s` bit is set. --------- start of INIT_FAX --------- ; ;execute this to start GPFax and trapdoor ; cd gpfax: run gpfax -nq -q waitforport REXX_GPFAX rx "address REXX_GPFAX unlisten" run mail:bin/trapdoor answer cd mail: ---------- end of INIT_FAX --------- This second script uses the OPENSERIAL/CLOSE serial commands, and thus will permit Trapdoor to use its"TOGGLE DTR" option to hang up any data orientated calls. --------- start of the MAIL:rec_fax script --------- rx "address REXX_GPFAX openserial" rx "address REXX_GPFAX fconreceive" rx "address REXX_GPFAX closeserial" wait 5 ; ;place other commands in here to automatically VIEW/PRINT/LOG any ;activity. ; ; ---------- end of the MAIL:rec_fax script -------- GPFax User Guide Page 92 The INIT_FAX script is shown below and can be EXECUTED or run if the `s` bit is set. --------- start of INIT_FAX --------- ; ;execute this to start GPFax and trapdoor ; cd gpfax: run gpfax -np -q waitforport REXX_GPFAX rx "address REXX_GPFAX closeserial" run mail:bin/trapdoor answer cd mail: --------- end of INIT_FAX --------- USING FaxGETTY AND GPFax Using FaxGETTY and GPFax is equally easy. All that is required are two scripts, an appropriate UULIB:PASSWB file and standard UUCP set-up. Some background on how things work: FaxGETTY is different from the normal GETTY because it watches for a FAX modem connection. When it receives a FAX connection, it looks for the USER FAX in PASSWD file then runs a script to start whatever you want to do get it going. This document covers only the FAX side of GETTY and GPFAX and the general usage of GETTY. You will require a startup script for which can automatically set things up for you and a script which initiates a FAX receive. The two scripts are documented below: GPFax User Guide Page 93 --------- startup script -------- ;execute this to start GPFax and FaxGETTY ; cd gpfax: run gpfax -np -q ;start GPFax quietly without the printer driver waitforport REXX_GPFAX rx "address REXX_GPFAX unlisten" cd uucp: run >nil: <nil: uucp:c/getty -Mh -B2400 -d0 -F AT ;run >nil: <nil: uucp:c/getty -Mh -B19200 -d0 -F AT ;use the line above for SUPRA modem (19200 may be changed to higher ;values for better throughput in DATA mode) ; ;end --------- end of script -------- GPFax is started in QUIET mode without the printer driver, so it does not interfere with normal system running. GETTY is then started for a Maestro modem which DOES NOT support baud rate locking. For more information on the GETTY commands, read the FaxGetty.doc and Getty.doc An example of a UULIB:PASSWD entry could be: fax,*,0,0,MrFAX,GPFAX:,uucp:rec_fax and the rec_fax script (with the `s` or script bit set) could do the following: -------- start of uucp:rec_fax script -------- rx "address REXX_GPFAX FCONRECEIVE" wait 5 ;do other logging stuff here ------------ end of uucp:rec_fax script -------- GPFax User Guide Page 94 APPENDIX A - VIEWFAX THE VIEWFAX PROGRAM Along with GPFax, we have provided a small stand-alone program for simple viewing and printing of any fax files stored in the CBM standard FAXX IFF format. The 'ViewFax' program will allow you to view and print all faxes created by GPFax and other programs. The program may be run from WorkBench or the CLI. Viewfax may also be included as a command in directory utilities like Directory Opus or DiskMaster, to provide a quick method of checking fax files. As with all our software, you may select the desired gadget function with the mouse or by pressing the key corresponding to the first letter of the gadget text. The cursor left and cursor right keys may be used to scroll the display instead of using the slider gadget. To run the program from WorkBench, single click on one or more fax icons, then while holding down the shift key, double click on the Viewfax icon. Viewfax accepts the following TOOLTYPES LORES=TRUE open non interlaced screen PRINTONLY=TRUE print the file directly, do not view VERBOSE=TRUE display file information To run the program from the CLI, enter Viewfax -<options><fax file name, fax file name, ...> where options are -L open on non interlaced screen -P print only, do not view -V display file information NOTES ON SAVING FAXES To save the viewed fax as a IFF ILBM image , select the 'Save' gadget. If RUNNING UNDER WORKBENCH 2.0x, the standard ASL filerequester will be displayed where you may select the path and file name. If RUNNING UNDER WORKBENCH 1.3, the file will automatically be saved in the same directory as the fax file with the name .IFF appended. ************************************************************************* * * * DO NOT PRINT from GPFax while GPFax is running with the printer * * driver option * * * ************************************************************************* GPFax User Guide Page 95 APPENDIX B - MODEMS TYPES OF MODEMS - CLASS 2 ONLY The GPFax class 2 version has been designed to conform to the draft TR29.9 Class 2 fax standard (August '91) for sending and receiving faxes with FAX/DATA modems. Unfortunately, the implementation of the standard varies slightly between different modem manufacturers. If the software is used with a Supra or Maestro modem, no extra settings are needed. (These modems use chip set from Rockwell and XR.) However, if the software is used with another brand of modem, some adjustments may be required. Under Class 2, GPFax expects the following Amiga to modem speed is locked at 19200 bits per second (The TR29.2 standard mandates 19200 but some modems can operate at higher speeds.) RTS/CTS handshaking must be enabled (&K3) Command echo should be disabled (E0) Verbose result codes (V1) Wait for dial tone before connect (X4)(except for manual send) Disconnect and return to command state with DTR transition (&D2) Manual Auto-Answer (SO=0) The default modem initialisation string is (For Supra use 'AT&F"E0', for ZyXEL use 'AT') With other brands of modems, if GPFax fails to correctly initialise the modem (for example if the 'WHERE's THE MODEM message appears) it can often be solved by simply changing the modem initialisation string to enable the above settings correctly. Some modems have these values as their default settings so no actual init string apart from AT is required. (See 'ENVIRONMENT'.) FAX/DATA AUTO-DETECTION If enabled, GPFax will auto detect between fax and data calls. This function operates correctly with most Class 2 Fax modems. (Supra, ZyXEL, Maestro etc.). The functions depends on the modem responding in a guaranteed manner when answering calls and therefore the function cannot be guaranteed with all brands of modems. GPFax User Guide Page 96 TYPES OF MODEMS - CLASS 1 The GPFax Class 1 version has been designed to support the T30 Class 1 fax standard for sending and receiving faxes with Fax/Data modems. Unfortunately there are often minor variations in the implementation of the standard from different modem manufacturers. See 'Loading GPFax' for TOOLTYPES settings for selecting the correct modem type. If your modem is not one of the types listed some adjustments may be required. Under Class 1, GPFax expects the following Amiga to modem speed is locked to 19200 bits per second. XON/XOFF handshaking is used. Command echo should be disabled (E0) Verbose result codes (V1) Wait for dial tone before connect (X4) (except for manual send) Disconnect and return to command state with DTR transition (&D2) Manual Auto-Answer (SO=0) The following default initialisation strings are used for various modems. AVTEK (Rockwell 224ATF) AT&F+C61E0B0X4&C1&D2&P1 USRobotics ATE0V1X4&D2S0=0&H2&B1 COMMA/SPIRIT (Analog devices) ATE0V1X4&D2*F2S0=0 Please refer to the modem manual for more details. With other brands of modems, if GPFax fails to correctly initialise the modem (for example if the 'WHERE's THE MODEM' message appears) it can often be solved by simply changing the modem initialisation string to enable the above settings correctly. (See 'ENVIRONMENT'.) FAX/DATA AUTO-DETECTION Because of different implementation in Class 1 modems, GPFax does not support adaptive answer (automatic detection between fax and data) in Class 1. Because of this Class 1 version does not support many of the extra ARexx commands to allow use with BBS's. If you wish to use GPFax with a BBS, use a Class 2 modem! SLOW MODEMS Some modems, such as those from USRobotics, will not accept the initialisation commands at full 19200 speed. In these cases, use the DELAY parameter in the TOOLTYPE to slow the transmission of characters. The DELAY command adds a defined millisecond delay between characters. GPFax User Guide Page 97 APPENDIX C - FAXX IFF The following is the C header file used by GPSoftware. It shows the standard IFF Form for storage of FAXX data as registered with CATS at CBM West Chester. /*********************************************************************** * FAX_IFF.H * * Richard Carde and Dr Greg Perry-GPSoftware, * * 21 Aloomba Rd Ashgrove Australia 4060. PH/Fax +61 7 3661402 * * UseNet: richardc@vogue.adsp.sub.org * * gregp@gpsoft.adsu.org * * Issue 1 September 1991 * ***********************************************************************/ /*********************************************************************** * FaxxIFF.h * ***********************************************************************/ #define ID_FAXX Make ID('F','A','X','X') #define ID_FXHD Make ID('F','X','H','D') #define ID_PAGE Make ID('P','A','G','E') #define ID_FLOG Make ID('F','L','O','G') /* LineLength codes */ #define FXLNGSTD 215 /* 1728 pixels along std line Ing of 215mm */ #define FXLNGLONG 215 /* 2084 pixels along opt line Ing of 255mm */ #define FXLNGLONGER 215 /* 2432 pixels along opt line Ing of 303mm */ #define FXLNGA5 215 /* 1216/1728 pixel along opt line Ing of 151mm */ #define FXLNGSA6 215 /* 864/1728 pixels along opt line Ing of 107mm */ /* VRes Codes */ #define FXVRESNORM 385 /* Normal resolution: 3.85 lines/mm */ #define FXVRESFINE 770 /* Fine resolution: 7.7 lines/mm */ /* Compression Cobes */ #define FXCMPHONE 0 /* No compression - available under Group IV */ #define FXCMPMH 1 /* One dimensional (MH) coding */ #define FXCMPMR 2 /* Two dimensional (MH) coding */ #define FXCMPMMR 4 /* Modified Two dimensional (MMR) coding */ GPFax User Guide Page 98 struct FaxHeader { UWORD Width Height; /* Image width and height, in pixels */ UWORD LineLength; /* Scan line length, in millimetres */ UWORD VRes; /* Vertical Resolution, in lines/100mm */ UBYTE Compression; /* Compression method */ UBYTE Pad [11]; /* Room for expansion */ }; /********************************************************************* * define as FAX form for any Group 3 fax * *********************************************************************/ #define ID_GPHD #define VRES_STD 0 /* standard mode 98 DPI */ #define VRES_FINE 1 /* fine res 198 DPI */ #define COMP_NONE 255 /* no compression - binary file */ #define COMP_ID 0 /* 1-D modified HUFFMAN */ #define COMP_2D 1 /* 2-D modified REED */ #define COMP_2DU 2 /* 2-D uncompressed REED */ #define COMP_2DM 3 /* 2_D modified modified REED */ /* VR-std scan time VR-fine */ #define ST_0_0MS 0 /* 0ms 0ms */ #define ST_5_5MS 1 /* 5ms 5ms */ #define ST_10_5MS 2 /* 10ms 5ms */ #define ST_10_10MS 3 /* 10ms 10ms */ #define ST_20_10MS 4 /* 20ms 10ms */ #define ST_20_20MS 5 /* 20ms 20ms */ #define ST_40_20MS 6 /* 40ms 20ms */ #define ST_40_40MS 7 /* 40ms 40ms */ #define PW_1728 0 /* 1728 pels in 215mm */ #define PW_2048 1 /* 2048 pels in 255mm */ #define PW_2432 2 /* 2432 pels in 303mm */ #define PW_1216 3 /* 1216 pels in 151mm */ #define PW_864 4 /* 865 pels in 107mm */ #define PH_UNLIM 0 /* unlimited page length */ #define PH_A4 1 /* A4 PAGE 297mm */ #define PH_B4 2 /* B4 PAGE 364mm */ GPFax User Guide Page 99 #define BR_2400 0 /* 2400 BITS PER SECOND */ #define BR_4800 1 #define BR_7200 2 #define BR_9600 3 #define BR_12000 4 #define BR_14400 5 #define ECM_NONE 0 /* Error Correction Disabled */ #define ECM_STD 1 /* Error Correction Enabled */ #define BFT_NONE 0 /* Binary Transfer Disabled */ #define BFT_STD 1 /* Binary Transfer Enabled */ struct GPHD { UWORD gp_Width; /* width in pels UWORD gp_Length; /* length / height in pels UWORD gp_Page; /* page number UBYTE gp_ID[22]; /* id string 20 ch NULL term UBYTE gp_VRES; /* Vertical Res dpi */ UBYTE gp_BitRate; /* connection bit rate */ UBYTE gp_PageWidth; /* page width */ UBYTE gp_PageLength; /* page length/height */ UBYTE gp_Compression; /* compression method */ UBYTE gp_ErrorCorrection; /* compression method */ UBYTE gp_BinaryFileTransfer; /* binary transfer mode */ UBYTE gp_ScanTime; /* Scan Time ms */ struct DateStamp gp_Date; /* date sent/received */ UBYTE gp_Pad[10]; }; GPFax User Guide Page 100 APPENDIX D - HANGUP CODES GPFax (Class 2 version only) reports the status codes as sent by the modem when sending and receiving faxes. The following is a list of those codes expressed in hexadecimal. This actual error may not have much meaning to you. ANY error generally means that the transmission FAILED! +------+---------------------------------------------------------+ | CODE | DESCRIPTION | +------+---------------------------------------------------------+ | | | | | 0-0F Call placement and termination codes | | 0 | Normal and proper end of connection | | 1 | Ring detected without successful handshake | | 2 | Call aborted, from +FKS or <CAN> | | 3 | No Loop Current | | 4 | Ringback detected, no answer timeout | | 5 | Ringback detected, answer without CED | | | | +------+---------------------------------------------------------+ | | | | | 10-1F Transmit Phase A and miscellaneous errors | | 10 | Unspecified Phase A error | | 11 | No Answer (T.30 T1 timeout) | | | | +------+---------------------------------------------------------+ | | | | | 20-3F Transmit Phase B Hangup Codes | | 20 | Unspecified Transmit phase B error | | 21 | Remote cannot receive or send | | 22 | COMREC error in transmit phase B | | 23 | COMREC invalid command received | | 24 | RSPREC error | | 25 | DCS send three times without response | | 26 | DIS/DTC received three times; DCS not recognised. | | 27 | Failure to train at 2400 or +FMS value | | 28 | RSPREC invalid response received | | | | +------+---------------------------------------------------------+ | | | | | 40-4F Transmit phase C Hangup Codes | | 40 | Unspecified Transmit Phase C error | | 41 | Unspecified Image format error | | 42 | Image conversion error | | 43 | DTE to DCT data underflow | | 44 | Unrecognised transparent data command | | 45 | Image error: line length wrong | | 46 | Image error: page length wrong | | 47 | Image error: wrong compression code | | | | +------+---------------------------------------------------------+ GPFax User Guide Page 101 +------+---------------------------------------------------------+ | CODE | DESCRIPTION | +------+---------------------------------------------------------+ | | | | | 50-5F Transmit Phase D Hangup Codes | | 50 | Unspecified Transmit Phase D error | | 51 | RSPREC error | | 52 | No response to MPS repeated three time | | 53 | Invalid response to MPS | | 54 | No response to EOP repeated three times | | 55 | Invalid response to EOP | | 56 | No response to EOM repeated three times | | 57 | Invalid response to EOM | | 58 | Unable to continue after PIN or PIP | | | | +------+---------------------------------------------------------+ | | | | | 70-7F Receive Phase B Hangup Codes | | 70 | Unspecified Receive Phase B error | | 71 | RSPREC error | | 72 | COMREC error | | 73 | T.30 T1 timeout, expected page was not received | | 74 | T.30 T1 timeout after EOM received | | | | +------+---------------------------------------------------------+ | | | | | 90-9F Receive Phase C Hangup Codes | | 90 | Unspecified Receive Phase C error | | 91 | Missing EOL after 5 seconds | | 92 | Bad CRC or frame (ECM or BFT modes) | | 93 | DCE to DTE buffer overflow | | | | +------+---------------------------------------------------------+ | | | | | A0-BF Receive Phase D Hangup Codes | | A0 | Unspecified Receive Phase D error | | A1 | RSPREC invalid response received | | A2 | COMREC invalid response received | | A3 | Unable to continue after PIN or PIP | | | | +------+---------------------------------------------------------+ | | | | | C0-FF - reserved codes - | | | | +------+---------------------------------------------------------+ Other errors are unspecified hardware errors. GPFax User Guide Page 102 ***** This page is intentionally left blank ***** GPFax User Guide Page 103 INDEX ABORT 62 SENDFAX 79 Adaptive Answer 75, 38 SENDFILE 76 Application icon 27, 40 STAMPBOTTOM 78 ARexx 27, 73 UNLISTEN 75, 82 Case of Strings 76 VIEWFAX 77 Creating Scripts 84 VIEWLAST 80 Function Keys 74 ASCII Text Files To Fax 51 GPFax Port 73 Assignments 19 on Data 43 AutoAnswer 37, 59 on Receive 43, 74 Automatic Paging 11 Return Codes 73 BADFILE 70 ARexx Commands Baud rate 27 AUTOANSWER 78 Baud rate locking 86 AUTOFAXDATA 78 BBS 74, 85 BAUDRATE 75, 82 BUSY 62 CLOSESERIAL 81 Buttons 21 COMPANYNAME 77 Colours 26 CONVERT 76 Commodore 2024 26 COVERPAGES 83 Company 31, 77 FAXFONT 80 Company Name 47 FAXTOIFF 76 Convert to Fax 50 FCONRECEIVE 83, 85 Cover Pages 56 IMAGESCALE 78 Scheduled 68 INITMODEM 81 Creating Faxes 12 LASTFILE 77 Cursor Keys 22 LINESPERPAGE 80 Custom screen 26 LISTEN 82 DataCall script 43 LOCKBAUD 82 DATACALL.GPF 90 MARGINS 80 Deleting Files 62 MODEMQUIET 78 Dial Mode 35 NOSYSREQ 78 Disk Space 15 OPENSERIAL 81 DISK! 63 PAPEMARKERS 78 Display Faxes 66 PAGEINATE 78 DUE 69 PRINTFAX 77 Editing Schedules 69 PRINTLAST 80 Environment 31 PRINTLOGREPORT 80 Default 30 PRTDRIVER 78 ERROR 70 PRTPOPUP 78 Error Messages 23 QUITFAX 77 ERRxxx 63 RECEIVENOW 83, 85 Extended Log Report 64 RECFAX 79 Facsimile machines 8 REPORLOG 80 FAIL 62 RESETSCHEDULES 83 FAILED 70 RESOLUTION 78 FAX# 48 REXXANSWER 78 Fax Header 10, 31 REXXDATA 78 Fax No 32 SCHEDULEFAX 82 Fax Resolution 10 SCHEDULER 78 SECURITY 78 GPFax User Guide Page 104 Fax/Data 96 Installation 18 ARexx 74 Intercharacter delay 28 FAX/DATA 39 JUNK 63 FAX_IN 15, 59 Junk Fax 42 FAX_OUT 15, 29, 54 LetterHead 32, 48 FAXID 32 Lines per Page 32, 34 FaxOut 24 Listen 86 FAXX IFF 98 Loading 26 FAXxxx.Pyy 29, 59 Log Report 37 Features 5 LogBook 60 File names 54 ARexx 73 File Requester 23 Manual Receive Fax 59 Floppy Drive Users 18 Manual Send 46, 58 Fonts 15, 33 Margins 10, 32 Default 32 Text 33 Form Feeds 40 MAXTRY 70 Formatting Commands 51 Memory 14, 66 Function Keys 74 Mode Gadgets 21 Fax/Data 39 Decision 21 Modem 5, 30, 34, 62, 86 Information 20 adaptive Answer 75 String 21 Class 1 97 GETTY 85 Class 2 96 GPFax: 19 incorrect responses 58 GPFax_env 29 Initialisation 35, 96 GPFax_log 29 Types 28 GPFax_pho 29 Quiet Mode 40 GPFax_sch 29 Multitasking 14 Group 55 no-serial 30 PhoneBook 45 NO_EOP 63 Group 3 Fax 8 NOANS 62 Huffman coding 8 NOISY 63 Theory 8 NOMEM 62 Handshaking 14 Numeric Keypad 22 Hangup Codes 101 Options 36 Hard Drives 18 OVERDUE 70 Iconified 27 PABX 35 Iconify 71 Page Markers 40 Icons 26 Page Mode 11 Program Created 29 Page Size 8, 17 IFF 32 PageStream 13, 16 Scaling 39 Pagination 34 IFF Images Paging 11, 39 Converting 11 PENDING 69 IFF Picture Files PenPal 13 converting to fax 50 Phone Book 44 Image Scale 39 PhoneBook 55 Imbedded commands 12, 51 Popup 68 Inactivity Timer 58 Postscript 61 Initialization string 27 Preferences 16 GPFax User Guide Page 105 Print Faxes 66, 12, 12 TFAX 54 Print Popup 68 TIME 63 Printer driver 10, 11, 12 ToolTypes 26 16, 17, 27, 37 Transmit Fax 54 Printing 16 Trapdoor Faxes 61 BBS Front End 85 Form Feeds 40 V 1.80 88 Popup 38 V 1.83 91 Professional Page 10 Unlisten 86 ProWrite 13, 16 User Interface 20 Prt Popup 37, 38 Versions 5 PRTxxx.Pyy 29 CLASS 1 28, 63 Re-Transmission of Fax 65 CLASS 2 27 Receive - ARexx 74 View Mode 41 Receive Fax 59 View Reports 60 Received Faxes 17 View Scheduled Faxes 70 Redial attempts 35 Viewfax Program 95 Reporting 37 Viewing Faxes Reports 61, 69 screen resolution 41 Extended 64 Voice# 48 Resolution 16 WB2 Icon 40 fax 66 WildCard 25 Setting 43 Windows ReSort Phone Book 49 Error 23 Retry 35, 70 File Requester 23 Rings 34 Popup 38 Silent Answer 39 Status 22 Saving Fax As IFF 67 WorkBench Screen 26 Scaling IFF Images 39 letterhead 48 Scheduler 37, 56, 68 Editing 69 Screen resolution Viewing Faxes 41 Security 42, 49, 59 Send Fax Immediate 56 Manual 46 Serial Device 14, 15, 27,30, 34, 81, 86 Shared 35, 87 Unit Number 34 Signature 32, 48 SILENT ANSWER 39 Speed 27, 46 Stamp Bottom 40 Status Windows 22 SUPRA 39, 96 T: 19 Telecomms Software 7 Text to fax 12 GPFax User Guide Page 106